X (Twitter)

X API

The core X API providing programmatic access to posts, users, spaces, lists, direct messages, bookmarks, likes, reposts, follows, blocks, mutes, trends, communities, and compliance data. Supports post creation, search (recent and full-archive), timelines, filtered streams, sampled streams, and real-time data access. Uses OAuth 2.0 with PKCE or OAuth 1.0a authentication with credit-based pay-per-use pricing.

Documentation GitHub OpenAPI

Documentation

https://docs.x.com/x-api

https://docs.x.com/x-api/getting-started/make-your-first-request

https://docs.x.com/x-api

https://docs.x.com/resources/fundamentals/authentication

https://docs.x.com/x-api/fundamentals/rate-limits

Specifications

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/openapi/x-api-openapi.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/graphql/twitter-graphql.md

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/apis.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-bookmark-and-remove-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-create-list-add-member-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-follow-list-by-id-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-follow-user-by-username-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-followers-of-handle-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-liked-posts-of-handle-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-list-detail-and-members-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-mentions-of-handle-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-mute-user-by-username-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-pin-owned-list-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-post-engagement-audit-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-post-like-cleanup-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-quote-post-from-search-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-reply-to-latest-post-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-repost-then-undo-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-reposters-of-latest-post-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-search-recent-get-details-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-unfollow-user-by-username-workflow.yml

https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/arazzo/twitter-user-lookup-recent-posts-workflow.yml

OpenAPI Specification

{
  "openapi": "3.0.0",
  "info": {
    "description": "X API v2 available endpoints",
    "version": "2.161",
    "title": "X API v2",
    "termsOfService": "https://developer.x.com/en/developer-terms/agreement-and-policy.html",
    "contact": {
      "name": "X Developers",
      "url": "https://developer.x.com/"
    },
    "license": {
      "name": "X Developer Agreement and Policy",
      "url": "https://developer.x.com/en/developer-terms/agreement-and-policy.html"
    }
  },
  "paths": {
    "/2/account_activity/replay/webhooks/{webhook_id}/subscriptions/all": {
      "post": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Create Replay Job",
        "description": "Creates a replay job to retrieve activities from up to the past 5 days for all subscriptions associated with a given webhook.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "createAccountActivityReplayJob",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "description": "The unique identifier for the webhook configuration.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookConfigId"
            },
            "style": "simple",
            "example": "1234567890"
          },
          {
            "name": "from_date",
            "in": "query",
            "description": "The oldest (starting) UTC timestamp (inclusive) from which events will be provided, in `yyyymmddhhmm` format.",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\d{12}$",
              "example": "202504242000"
            },
            "style": "form",
            "example": "202504242000"
          },
          {
            "name": "to_date",
            "in": "query",
            "description": "The latest (ending) UTC timestamp (exclusive) up to which events will be provided, in `yyyymmddhhmm` format.",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^\\d{12}$",
              "example": "202504242200"
            },
            "style": "form",
            "example": "202504242200"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReplayJobCreateResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/account_activity/subscriptions/count": {
      "get": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Get Subscription Count",
        "description": "Retrieves a count of currently active Account Activity subscriptions.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "getAccountActivitySubscriptionCount",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsCountGetResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/account_activity/webhooks/{webhook_id}/subscriptions/all": {
      "get": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.read",
              "dm.write",
              "tweet.read",
              "users.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Validate Subscription",
        "description": "Checks a user\u2019s Account Activity subscription for a given webhook.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "validateAccountActivitySubscription",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "description": "The webhook ID to check subscription against.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookConfigId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsGetResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      },
      "post": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.read",
              "dm.write",
              "tweet.read",
              "users.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Create Subscription",
        "description": "Creates an Account Activity subscription for the user and the given webhook.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "createAccountActivitySubscription",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "description": "The webhook ID to check subscription against.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookConfigId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubscriptionsCreateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsCreateResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/account_activity/webhooks/{webhook_id}/subscriptions/all/list": {
      "get": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Get Subscriptions",
        "description": "Retrieves a list of all active subscriptions for a given webhook.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "getAccountActivitySubscriptions",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "description": "The webhook ID to pull subscriptions for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookConfigId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsListGetResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/account_activity/webhooks/{webhook_id}/subscriptions/{user_id}/all": {
      "delete": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Account Activity"
        ],
        "summary": "X Delete Subscription",
        "description": "Deletes an Account Activity subscription for the given webhook and user ID.",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/account-activity/introduction"
        },
        "operationId": "deleteAccountActivitySubscription",
        "parameters": [
          {
            "name": "webhook_id",
            "in": "path",
            "description": "The webhook ID to check subscription against.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookConfigId"
            },
            "style": "simple",
            "example": "1234567890"
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "User ID to unsubscribe from.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/UserId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsDeleteResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/activity/stream": {
      "get": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Activity",
          "Stream"
        ],
        "summary": "X Activity Stream",
        "description": "Stream of X Activities",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/activity-stream"
        },
        "operationId": "activityStream",
        "parameters": [
          {
            "name": "backfill_minutes",
            "in": "query",
            "description": "The number of minutes of backfill requested.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 5,
              "format": "int32"
            },
            "style": "form",
            "example": 42
          },
          {
            "name": "start_time",
            "in": "query",
            "description": "YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Post labels will be provided.",
            "required": false,
            "example": "2021-02-01T18:40:40.000Z",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "style": "form"
          },
          {
            "name": "end_time",
            "in": "query",
            "description": "YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp from which the Post labels will be provided.",
            "required": false,
            "example": "2021-02-01T18:40:40.000Z",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivityStreamingResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-twitter-streaming": true,
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/activity/subscriptions": {
      "delete": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Activity"
        ],
        "summary": "X Delete X Activity Subscriptions by IDs",
        "description": "Deletes multiple subscriptions for X activity events by their IDs",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/delete-x-activity-subscriptions-by-ids"
        },
        "operationId": "deleteActivitySubscriptionsByIds",
        "parameters": [
          {
            "name": "ids",
            "in": "query",
            "description": "Comma-separated list of subscription IDs to delete.",
            "required": true,
            "schema": {
              "type": "array",
              "minItems": 1,
              "maxItems": 100,
              "items": {
                "$ref": "#/components/schemas/ActivitySubscriptionId"
              }
            },
            "explode": false,
            "style": "form",
            "example": []
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivitySubscriptionDeleteResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      },
      "get": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Activity"
        ],
        "summary": "X Get X Activity Subscriptions",
        "description": "Get a list of active subscriptions for XAA",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/get-x-activity-subscriptions"
        },
        "operationId": "getActivitySubscriptions",
        "parameters": [
          {
            "name": "max_results",
            "in": "query",
            "description": "The maximum number of results to return per page.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "format": "int32"
            },
            "style": "form",
            "example": 10
          },
          {
            "name": "pagination_token",
            "in": "query",
            "description": "This parameter is used to get the next 'page' of results.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/PaginationToken32"
            },
            "style": "form",
            "example": "next_token_abc123"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivitySubscriptionGetResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      },
      "post": {
        "security": [
          {
            "BearerToken": []
          },
          {
            "OAuth2UserToken": [
              "dm.read",
              "tweet.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Activity",
          "Stream"
        ],
        "summary": "X Create X Activity Subscription",
        "description": "Creates a subscription for an X activity event",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/create-x-activity-subscription"
        },
        "operationId": "createActivitySubscription",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActivitySubscriptionCreateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivitySubscriptionCreateResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/activity/subscriptions/{subscription_id}": {
      "delete": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Activity"
        ],
        "summary": "X Deletes X Activity Subscription",
        "description": "Deletes a subscription for an X activity event",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/deletes-x-activity-subscription"
        },
        "operationId": "deleteActivitySubscription",
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "description": "The ID of the subscription to delete.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/ActivitySubscriptionId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivitySubscriptionDeleteResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      },
      "put": {
        "security": [
          {
            "BearerToken": []
          }
        ],
        "tags": [
          "Activity"
        ],
        "summary": "X Update X Activity Subscription",
        "description": "Updates a subscription for an X activity event",
        "externalDocs": {
          "url": "https://docs.x.com/x-api/activity/update-x-activity-subscription"
        },
        "operationId": "updateActivitySubscription",
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "description": "The ID of the subscription to update.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/ActivitySubscriptionId"
            },
            "style": "simple",
            "example": "1234567890"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActivitySubscriptionUpdateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivitySubscriptionUpdateResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/chat/conversations": {
      "get": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.read",
              "users.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Chat"
        ],
        "summary": "X Get Chat Conversations",
        "description": "Retrieves a list of Chat conversations for the authenticated user's inbox.",
        "externalDocs": {
          "url": "https://developer.x.com/"
        },
        "operationId": "getChatConversations",
        "parameters": [
          {
            "name": "max_results",
            "in": "query",
            "description": "Maximum number of conversations to return.",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "format": "int32",
              "default": 10
            },
            "style": "form",
            "example": 10
          },
          {
            "name": "pagination_token",
            "in": "query",
            "description": "Token for pagination to retrieve the next page of results.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "style": "form",
            "example": "next_token_abc123"
          },
          {
            "$ref": "#/components/parameters/ChatConversationFieldsParameter"
          },
          {
            "$ref": "#/components/parameters/ChatConversationExpansionsParameter"
          },
          {
            "$ref": "#/components/parameters/UserFieldsParameter"
          }
        ],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatGetConversationsResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/chat/conversations/group": {
      "post": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.write",
              "tweet.read",
              "users.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Chat"
        ],
        "summary": "X Create Chat Group Conversation",
        "description": "Creates a new encrypted Chat group conversation on behalf of the authenticated user.",
        "externalDocs": {
          "url": "https://developer.x.com/"
        },
        "operationId": "createChatConversation",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChatCreateConversationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatCreateConversationResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/chat/conversations/group/initialize": {
      "post": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.write"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Chat"
        ],
        "summary": "X Initialize Chat Group",
        "description": "Initializes a new XChat group conversation and returns a unique conversation ID.\n\nThis endpoint is the first step in creating a group chat. The returned conversation_id \nshould be used in subsequent calls to POST /chat/conversations/group to fully create and \nconfigure the group with members, admins, encryption keys, and other settings.\n\n**Workflow:**\n1. Call this endpoint to get a `conversation_id`\n2. Use that `conversation_id` when calling `POST /chat/conversations/group` to create the group\n\n**Authentication:**\n- Requires OAuth 1.0a User Context or OAuth 2.0 User Context\n- Required scope: `dm.write`\n",
        "externalDocs": {
          "url": "https://developer.x.com/"
        },
        "operationId": "initializeChatGroup",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The request has succeeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatInitializeGroupResponse"
                }
              }
            }
          },
          "default": {
            "description": "The request has failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              },
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/2/chat/conversations/{id}": {
      "get": {
        "security": [
          {
            "OAuth2UserToken": [
              "dm.read",
              "tweet.read",
              "users.read"
            ]
          },
          {
            "UserToken": []
          }
        ],
        "tags": [
          "Chat"
        ],
        "summary": "X Get Chat Conversation",
        "description": "Retrieves messages and key change events for a specific Chat conversation with pagination support. For 1:1 conversations, provide the recipient's user ID; the server constructs the canonical conversation ID from the authenticated user and recipient.",
        "externalDocs": {
          "url": "https://developer.x.com/"
        },
        "operationId": "getChatConversation",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            

# --- truncated at 32 KB (782 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/openapi/x-api-openapi.json