> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# twitter-api

> Twitter API

**Server path:** `/twitter-api` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                            | Description                                                                                                         |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| [`twitter_delete_tweet`](#twitter_delete_tweet)                 | Delete Posts                                                                                                        |
| [`twitter_follow_user`](#twitter_follow_user)                   | Follow a user on behalf of the authenticated account. Resolves the authenticated user id automatically.             |
| [`twitter_get_followers`](#twitter_get_followers)               | Get Users Followers                                                                                                 |
| [`twitter_get_following`](#twitter_get_following)               | Get Users Following                                                                                                 |
| [`twitter_get_home_timeline`](#twitter_get_home_timeline)       | Get the authenticated user's reverse-chronological home timeline. Resolves the authenticated user id automatically. |
| [`twitter_get_me`](#twitter_get_me)                             | Get Users Me                                                                                                        |
| [`twitter_get_mentions`](#twitter_get_mentions)                 | Get tweets mentioning the authenticated user. Resolves the authenticated user id automatically.                     |
| [`twitter_get_tweet`](#twitter_get_tweet)                       | Get Posts by ID                                                                                                     |
| [`twitter_get_user_by_id`](#twitter_get_user_by_id)             | Get Users by ID                                                                                                     |
| [`twitter_get_user_by_username`](#twitter_get_user_by_username) | Get Users by Username                                                                                               |
| [`twitter_get_user_timeline`](#twitter_get_user_timeline)       | Get Users Posts                                                                                                     |
| [`twitter_like_tweet`](#twitter_like_tweet)                     | Like a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.              |
| [`twitter_post_tweet`](#twitter_post_tweet)                     | Post a new tweet, optionally with attached media, as a reply, or quoting another tweet.                             |
| [`twitter_retweet`](#twitter_retweet)                           | Retweet (repost) a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.  |
| [`twitter_search_tweets`](#twitter_search_tweets)               | Search Posts Recent                                                                                                 |
| [`twitter_unfollow_user`](#twitter_unfollow_user)               | Unfollow a user on behalf of the authenticated account. Resolves the authenticated user id automatically.           |
| [`twitter_unlike_tweet`](#twitter_unlike_tweet)                 | Unlike a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.            |
| [`twitter_unretweet`](#twitter_unretweet)                       | Remove a retweet on behalf of the authenticated account. Resolves the authenticated user id automatically.          |
| [`twitter_upload_media`](#twitter_upload_media)                 | Upload media (image/video/gif) from a URL for use in a tweet, optionally with alt text.                             |

***

## twitter\_delete\_tweet

Delete Posts

**Parameters:**

| Parameter  | Type   | Required | Default | Description                 |
| ---------- | ------ | -------- | ------- | --------------------------- |
| `tweet_id` | string | Yes      | —       | Unique identifier of a Post |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of a Post"
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_follow\_user

Follow a user on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter        | Type   | Required | Default | Description                             |
| ---------------- | ------ | -------- | ------- | --------------------------------------- |
| `target_user_id` | string | Yes      | —       | Unique identifier of the user to follow |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "target_user_id": {
        "type": "string",
        "description": "Unique identifier of the user to follow"
      }
    },
    "required": [
      "PCID",
      "target_user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_followers

Get Users Followers

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                       |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------- |
| `user_id`          | string    | Yes      | —       | Unique identifier of a User                       |
| `max_results`      | integer   | No       | —       | Max Results                                       |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.             |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display. |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "user_id": {
        "type": "string",
        "description": "Unique identifier of a User"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "pinned_tweet_id"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      }
    },
    "required": [
      "PCID",
      "user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_following

Get Users Following

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                       |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------- |
| `user_id`          | string    | Yes      | —       | Unique identifier of a User                       |
| `max_results`      | integer   | No       | —       | Max Results                                       |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.             |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display. |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "user_id": {
        "type": "string",
        "description": "Unique identifier of a User"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "pinned_tweet_id"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      }
    },
    "required": [
      "PCID",
      "user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_home\_timeline

Get the authenticated user's reverse-chronological home timeline. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                       |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------- |
| `max_results`      | integer   | No       | —       | Max Results                                       |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.             |
| `start_time`       | string    | No       | —       | Must be on or after 2010-11-06.                   |
| `end_time`         | string    | No       | —       | Must be on or after 2010-11-06.                   |
| `since_id`         | string    | No       | —       | Since Id                                          |
| `until_id`         | string    | No       | —       | Until Id                                          |
| `exclude`          | string\[] | No       | —       | The exclude value                                 |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display. |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "start_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "end_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "since_id": {
        "type": "string",
        "description": "Since Id"
      },
      "until_id": {
        "type": "string",
        "description": "Until Id"
      },
      "exclude": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "replies",
            "retweets"
          ]
        },
        "description": "The exclude value"
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of Post fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of fields to expand."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of User fields to display."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_me

Get Users Me

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                       |
| -------------- | --------- | -------- | ------- | ------------------------------------------------- |
| `user_fields`  | string\[] | No       | —       | A comma separated list of User fields to display. |
| `expansions`   | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `tweet_fields` | string\[] | No       | —       | A comma separated list of Post fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "pinned_tweet_id"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_mentions

Get tweets mentioning the authenticated user. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                       |
| ------------------ | --------- | -------- | ------- | ------------------------------------------------- |
| `max_results`      | integer   | No       | —       | Max Results                                       |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.             |
| `start_time`       | string    | No       | —       | Must be on or after 2010-11-06.                   |
| `end_time`         | string    | No       | —       | Must be on or after 2010-11-06.                   |
| `since_id`         | string    | No       | —       | Since Id                                          |
| `until_id`         | string    | No       | —       | Until Id                                          |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display. |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "start_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "end_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "since_id": {
        "type": "string",
        "description": "Since Id"
      },
      "until_id": {
        "type": "string",
        "description": "Until Id"
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of Post fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of fields to expand."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "A comma separated list of User fields to display."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_tweet

Get Posts by ID

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                        |
| -------------- | --------- | -------- | ------- | -------------------------------------------------- |
| `tweet_id`     | string    | Yes      | —       | Unique identifier of a Post                        |
| `tweet_fields` | string\[] | No       | —       | A comma separated list of Post fields to display.  |
| `expansions`   | string\[] | No       | —       | A comma separated list of fields to expand.        |
| `user_fields`  | string\[] | No       | —       | A comma separated list of User fields to display.  |
| `media_fields` | string\[] | No       | —       | A comma separated list of Media fields to display. |
| `poll_fields`  | string\[] | No       | —       | A comma separated list of Poll fields to display.  |
| `place_fields` | string\[] | No       | —       | A comma separated list of Place fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of a Post"
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article.cover_media",
            "article.media_entities",
            "attachments.media_keys",
            "attachments.media_source_tweet",
            "attachments.poll_ids",
            "author_id",
            "edit_history_tweet_ids",
            "entities.mentions.username",
            "geo.place_id",
            "in_reply_to_user_id",
            "referenced_tweets.id",
            "username"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "media_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "alt_text",
            "duration_ms",
            "height",
            "media_key",
            "non_public_metrics",
            "organic_metrics",
            "preview_image_url",
            "promoted_metrics",
            "public_metrics",
            "type",
            "url",
            "variants",
            "width"
          ]
        },
        "description": "A comma separated list of Media fields to display."
      },
      "poll_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "duration_minutes",
            "end_datetime",
            "id",
            "options",
            "voting_status"
          ]
        },
        "description": "A comma separated list of Poll fields to display."
      },
      "place_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "contained_within",
            "country",
            "country_code",
            "full_name",
            "geo",
            "id",
            "name",
            "place_type"
          ]
        },
        "description": "A comma separated list of Place fields to display."
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_user\_by\_id

Get Users by ID

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                       |
| -------------- | --------- | -------- | ------- | ------------------------------------------------- |
| `user_id`      | string    | Yes      | —       | Unique identifier of a User                       |
| `user_fields`  | string\[] | No       | —       | A comma separated list of User fields to display. |
| `expansions`   | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `tweet_fields` | string\[] | No       | —       | A comma separated list of Post fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "user_id": {
        "type": "string",
        "description": "Unique identifier of a User"
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "pinned_tweet_id"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      }
    },
    "required": [
      "PCID",
      "user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_user\_by\_username

Get Users by Username

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                       |
| -------------- | --------- | -------- | ------- | ------------------------------------------------- |
| `username`     | string    | Yes      | —       | The username value                                |
| `user_fields`  | string\[] | No       | —       | A comma separated list of User fields to display. |
| `expansions`   | string\[] | No       | —       | A comma separated list of fields to expand.       |
| `tweet_fields` | string\[] | No       | —       | A comma separated list of Post fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "username": {
        "type": "string",
        "description": "The username value"
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "pinned_tweet_id"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      }
    },
    "required": [
      "PCID",
      "username"
    ]
  }
  ```
</Expandable>

***

## twitter\_get\_user\_timeline

Get Users Posts

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                        |
| ------------------ | --------- | -------- | ------- | -------------------------------------------------- |
| `user_id`          | string    | Yes      | —       | Unique identifier of a User                        |
| `max_results`      | integer   | No       | —       | Max Results                                        |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.              |
| `start_time`       | string    | No       | —       | Must be on or after 2010-11-06.                    |
| `end_time`         | string    | No       | —       | Must be on or after 2010-11-06.                    |
| `since_id`         | string    | No       | —       | Since Id                                           |
| `until_id`         | string    | No       | —       | Until Id                                           |
| `exclude`          | string\[] | No       | —       | The exclude value                                  |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display.  |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.        |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display.  |
| `media_fields`     | string\[] | No       | —       | A comma separated list of Media fields to display. |
| `poll_fields`      | string\[] | No       | —       | A comma separated list of Poll fields to display.  |
| `place_fields`     | string\[] | No       | —       | A comma separated list of Place fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "user_id": {
        "type": "string",
        "description": "Unique identifier of a User"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "start_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "end_time": {
        "type": "string",
        "description": "Must be on or after 2010-11-06."
      },
      "since_id": {
        "type": "string",
        "description": "Since Id"
      },
      "until_id": {
        "type": "string",
        "description": "Until Id"
      },
      "exclude": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "replies",
            "retweets"
          ]
        },
        "description": "The exclude value"
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article.cover_media",
            "article.media_entities",
            "attachments.media_keys",
            "attachments.media_source_tweet",
            "attachments.poll_ids",
            "author_id",
            "edit_history_tweet_ids",
            "entities.mentions.username",
            "geo.place_id",
            "in_reply_to_user_id",
            "referenced_tweets.id",
            "username"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "media_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "alt_text",
            "duration_ms",
            "height",
            "media_key",
            "non_public_metrics",
            "organic_metrics",
            "preview_image_url",
            "promoted_metrics",
            "public_metrics",
            "type",
            "url",
            "variants",
            "width"
          ]
        },
        "description": "A comma separated list of Media fields to display."
      },
      "poll_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "duration_minutes",
            "end_datetime",
            "id",
            "options",
            "voting_status"
          ]
        },
        "description": "A comma separated list of Poll fields to display."
      },
      "place_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "contained_within",
            "country",
            "country_code",
            "full_name",
            "geo",
            "id",
            "name",
            "place_type"
          ]
        },
        "description": "A comma separated list of Place fields to display."
      }
    },
    "required": [
      "PCID",
      "user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_like\_tweet

Like a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter  | Type   | Required | Default | Description                            |
| ---------- | ------ | -------- | ------- | -------------------------------------- |
| `tweet_id` | string | Yes      | —       | Unique identifier of the tweet to like |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of the tweet to like"
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_post\_tweet

Post a new tweet, optionally with attached media, as a reply, or quoting another tweet.

**Parameters:**

| Parameter           | Type      | Required | Default | Description                                                     |
| ------------------- | --------- | -------- | ------- | --------------------------------------------------------------- |
| `text`              | string    | No       | —       | Text of the tweet. Required unless media\_ids is provided.      |
| `media_ids`         | string\[] | No       | —       | Media IDs to attach to the tweet (from twitter\_upload\_media). |
| `reply_to_tweet_id` | string    | No       | —       | The ID of the tweet being replied to.                           |
| `quote_tweet_id`    | string    | No       | —       | Tweet ID to quote.                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "text": {
        "type": "string",
        "description": "Text of the tweet. Required unless media_ids is provided."
      },
      "media_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Media IDs to attach to the tweet (from twitter_upload_media)."
      },
      "reply_to_tweet_id": {
        "type": "string",
        "description": "The ID of the tweet being replied to."
      },
      "quote_tweet_id": {
        "type": "string",
        "description": "Tweet ID to quote."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## twitter\_retweet

Retweet (repost) a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter  | Type   | Required | Default | Description                               |
| ---------- | ------ | -------- | ------- | ----------------------------------------- |
| `tweet_id` | string | Yes      | —       | Unique identifier of the tweet to retweet |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of the tweet to retweet"
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_search\_tweets

Search Posts Recent

**Parameters:**

| Parameter          | Type      | Required | Default | Description                                        |
| ------------------ | --------- | -------- | ------- | -------------------------------------------------- |
| `query`            | string    | Yes      | —       | Search query string                                |
| `max_results`      | integer   | No       | —       | Max Results                                        |
| `next_token`       | string    | No       | —       | A base32hex-encoded pagination token.              |
| `pagination_token` | string    | No       | —       | A base32hex-encoded pagination token.              |
| `start_time`       | string    | No       | —       | Must be within the last 7 days.                    |
| `end_time`         | string    | No       | —       | End Time                                           |
| `since_id`         | string    | No       | —       | Since Id                                           |
| `until_id`         | string    | No       | —       | Until Id                                           |
| `sort_order`       | string    | No       | —       | Sort Order                                         |
| `tweet_fields`     | string\[] | No       | —       | A comma separated list of Post fields to display.  |
| `expansions`       | string\[] | No       | —       | A comma separated list of fields to expand.        |
| `user_fields`      | string\[] | No       | —       | A comma separated list of User fields to display.  |
| `media_fields`     | string\[] | No       | —       | A comma separated list of Media fields to display. |
| `poll_fields`      | string\[] | No       | —       | A comma separated list of Poll fields to display.  |
| `place_fields`     | string\[] | No       | —       | A comma separated list of Place fields to display. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "query": {
        "type": "string",
        "description": "Search query string"
      },
      "max_results": {
        "type": "integer",
        "description": "Max Results"
      },
      "next_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "pagination_token": {
        "type": "string",
        "description": "A base32hex-encoded pagination token."
      },
      "start_time": {
        "type": "string",
        "description": "Must be within the last 7 days."
      },
      "end_time": {
        "type": "string",
        "description": "End Time"
      },
      "since_id": {
        "type": "string",
        "description": "Since Id"
      },
      "until_id": {
        "type": "string",
        "description": "Until Id"
      },
      "sort_order": {
        "type": "string",
        "description": "Sort Order",
        "enum": [
          "recency",
          "relevancy"
        ]
      },
      "tweet_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article",
            "article_title",
            "attachments",
            "card_uri",
            "community_id",
            "context_annotations",
            "conversation_id",
            "created_at",
            "display_text_range",
            "edit_controls",
            "entities",
            "geo",
            "id",
            "lang",
            "matched_media_notes",
            "media_metadata",
            "non_public_metrics",
            "note_post",
            "note_request_suggestions",
            "organic_metrics",
            "paid_partnership",
            "possibly_sensitive",
            "promoted_metrics",
            "public_metrics",
            "reply_settings",
            "scopes",
            "source",
            "suggested_source_links",
            "suggested_source_links_with_counts",
            "text",
            "withheld"
          ]
        },
        "description": "A comma separated list of Post fields to display."
      },
      "expansions": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "article.cover_media",
            "article.media_entities",
            "attachments.media_keys",
            "attachments.media_source_tweet",
            "attachments.poll_ids",
            "author_id",
            "edit_history_tweet_ids",
            "entities.mentions.username",
            "geo.place_id",
            "in_reply_to_user_id",
            "referenced_tweets.id",
            "username"
          ]
        },
        "description": "A comma separated list of fields to expand."
      },
      "user_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "affiliation",
            "confirmed_email",
            "connection_status",
            "created_at",
            "description",
            "entities",
            "id",
            "is_identity_verified",
            "location",
            "most_recent_tweet_id",
            "name",
            "parody",
            "pinned_tweet_id",
            "profile_banner_url",
            "profile_image_url",
            "protected",
            "public_metrics",
            "receives_your_dm",
            "subscribes_to_you",
            "subscription",
            "subscription_type",
            "url",
            "username",
            "verified",
            "verified_followers_count",
            "verified_type",
            "withheld"
          ]
        },
        "description": "A comma separated list of User fields to display."
      },
      "media_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "alt_text",
            "duration_ms",
            "height",
            "media_key",
            "non_public_metrics",
            "organic_metrics",
            "preview_image_url",
            "promoted_metrics",
            "public_metrics",
            "type",
            "url",
            "variants",
            "width"
          ]
        },
        "description": "A comma separated list of Media fields to display."
      },
      "poll_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "duration_minutes",
            "end_datetime",
            "id",
            "options",
            "voting_status"
          ]
        },
        "description": "A comma separated list of Poll fields to display."
      },
      "place_fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "contained_within",
            "country",
            "country_code",
            "full_name",
            "geo",
            "id",
            "name",
            "place_type"
          ]
        },
        "description": "A comma separated list of Place fields to display."
      }
    },
    "required": [
      "PCID",
      "query"
    ]
  }
  ```
</Expandable>

***

## twitter\_unfollow\_user

Unfollow a user on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter        | Type   | Required | Default | Description                               |
| ---------------- | ------ | -------- | ------- | ----------------------------------------- |
| `target_user_id` | string | Yes      | —       | Unique identifier of the user to unfollow |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "target_user_id": {
        "type": "string",
        "description": "Unique identifier of the user to unfollow"
      }
    },
    "required": [
      "PCID",
      "target_user_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_unlike\_tweet

Unlike a tweet on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter  | Type   | Required | Default | Description                              |
| ---------- | ------ | -------- | ------- | ---------------------------------------- |
| `tweet_id` | string | Yes      | —       | Unique identifier of the tweet to unlike |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of the tweet to unlike"
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_unretweet

Remove a retweet on behalf of the authenticated account. Resolves the authenticated user id automatically.

**Parameters:**

| Parameter  | Type   | Required | Default | Description                                         |
| ---------- | ------ | -------- | ------- | --------------------------------------------------- |
| `tweet_id` | string | Yes      | —       | Unique identifier of the originally retweeted tweet |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "tweet_id": {
        "type": "string",
        "description": "Unique identifier of the originally retweeted tweet"
      }
    },
    "required": [
      "PCID",
      "tweet_id"
    ]
  }
  ```
</Expandable>

***

## twitter\_upload\_media

Upload media (image/video/gif) from a URL for use in a tweet, optionally with alt text.

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                    |
| ---------------- | ------ | -------- | ------- | -------------------------------------------------------------- |
| `media_url`      | string | Yes      | —       | Publicly accessible URL of the media to upload                 |
| `media_category` | string | No       | —       | The category of the media being uploaded                       |
| `alt_text`       | string | No       | —       | Optional accessibility alt text for the media (max 1000 chars) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "media_url": {
        "type": "string",
        "description": "Publicly accessible URL of the media to upload"
      },
      "media_category": {
        "type": "string",
        "description": "The category of the media being uploaded",
        "enum": [
          "tweet_image",
          "tweet_video",
          "tweet_gif",
          "dm_image",
          "dm_video",
          "dm_gif",
          "subtitles"
        ]
      },
      "alt_text": {
        "type": "string",
        "description": "Optional accessibility alt text for the media (max 1000 chars)"
      }
    },
    "required": [
      "PCID",
      "media_url"
    ]
  }
  ```
</Expandable>