X (Twitter)

Stream of X Activities

Adds one or more members to an existing encrypted Chat group conversation, rotating the conversation key.

Adds (initializes or rotates) the encryption keys for a Chat conversation. Call this before sending messages in a new 1:1 conversation, and again with a newer key version to rotate the conversation key. For 1:1 conversations, provide the recipient's user ID as the conversation_id. The server constructs the canonical conversation ID from the authenticated user and recipient. The request body must contain the conversation key version and participant keys (the conversation key encrypted for each participant using their public key). **Workflow (new 1:1 conversation):** 1. Generate a conversation key using the SDK 2. Encrypt the key for both participants using their public keys 3. Call this endpoint to register the keys 4. Send messages using `POST /chat/conversations/{id}/messages` To rotate the keys of an existing conversation, repeat the same call with a newer conversation key version. **Authentication:** - Requires OAuth 1.0a User Context or OAuth 2.0 User Context - Required scopes: `tweet.read`, `users.read`, `dm.write`

Adds a User to a specific List by its ID.

Registers a user's public key for X Chat encryption.

Appends data to a Media upload request.

Creates a new Article draft that can later be published.

Publishes a draft Article, making it publicly visible.

Blocks direct messages to or from a specific User by their ID for the authenticated user.

Downloads encrypted media bytes from an XChat conversation. The response body contains raw binary bytes. For 1:1 conversations, provide the recipient's user ID; the server constructs the canonical conversation ID from the authenticated user and recipient.

Appends media data to an XChat upload session.

Finalizes an XChat media upload session.

Initializes an XChat media upload session.

Creates an Account Activity subscription for the user and the given webhook.

Creates a subscription for an X activity event

Creates a new encrypted Chat group conversation on behalf of the authenticated user.

Creates a community note endpoint for LLM use case.

Creates a new Compliance Job for the specified job type.

Sends a new direct message to a specific conversation by its ID.

Sends a new direct message to a specific participant by their ID.

Initiates a new direct message conversation with specified participants.

Creates a new List for the authenticated user.

Creates metadata for a Media file.

Creates subtitles for a specific Media file.

Creates a new Post for the authenticated user, or edits an existing Post when edit_options are provided. Supports paid partnership disclosure via the paid_partnership field.

Adds a post to the authenticated user’s bookmarks.

Creates a replay job to retrieve events from up to the past 24 hours for all events delivered or attempted to be delivered to the webhook.

Creates a new webhook configuration.

Creates a link to deliver FilteredStream events to the given webhook.

Deletes an Account Activity subscription for the given webhook and user ID.

Deletes a subscription for an X activity event

Deletes multiple subscriptions for X activity events by their IDs

Terminates all active streaming connections for the authenticated application.

Deletes a community note.

Terminates all streaming connections for a specific endpoint ID for the authenticated application.

Terminates multiple streaming connections by their UUIDs for the authenticated application.

Deletes a specific direct message event by its ID, if owned by the authenticated user.

Deletes a specific List owned by the authenticated user by its ID.

Deletes subtitles for a specific Media file.

Deletes a specific Post by its ID, if owned by the authenticated user.

Removes a Post from the authenticated user’s Bookmarks by its ID.

Deletes an existing webhook configuration.

Deletes a link from FilteredStream events to the given webhook.

Downloads media attached to a legacy Direct Message. The requesting user must be a participant in the conversation containing the specified DM event. The response body contains raw binary bytes.

Endpoint to evaluate a community note.

Finalizes a Media upload request.

Causes the authenticated user to follow a specific List by its ID.

Causes the authenticated user to follow a specific user by their ID.

Retrieves a count of currently active Account Activity subscriptions.

Retrieves a list of all active subscriptions for a given webhook.

Get a list of active subscriptions for XAA

Returns metadata for a Chat conversation including type, muted status, and group details. Use chat_conversation.fields to select which fields are returned. Use expansions to hydrate member, admin, or participant user objects. Use user.fields to control which profile fields are returned for expanded users.

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.

Retrieves a list of Chat conversations for the authenticated user's inbox.

Retrieves details of a specific Community by its ID.

Retrieves a list of Compliance Jobs filtered by job type and optional status.

Retrieves details of a specific Compliance Job by its ID.

Returns active and historical streaming connections with disconnect reasons for the authenticated application.

Retrieves a list of recent direct message events across all conversations.

Retrieves direct message events for a specific conversation.

Retrieves details of a specific direct message event by its ID.

Retrieves direct message events for a specific conversation.

Retrieves historical engagement metrics for specified Posts within a defined time range.

Retrieves engagement metrics for specified Posts over the last 28 hours.

Retrieves details of a specific List by its ID.

Retrieves a list of Users who follow a specific List by its ID.

Retrieves a list of Users who are members of a specific List by its ID.

Retrieves a list of Posts associated with a specific List by its ID.

Retrieves analytics data for media.

Retrieves details of a specific Media file by its media key.

Retrieves details of Media files by their media keys.

Retrieves the status of a Media upload by its ID.

Retrieves news story by its ID.

Retrieves the full OpenAPI Specification in JSON format. (See https://github.com/OAI/OpenAPI-Specification/blob/master/README.md)

Retrieves analytics data for specified Posts within a defined time range.

Retrieves details of a specific Post by its ID.

Retrieves details of multiple Posts by their IDs.

Retrieves the count of Posts matching a search query from the full archive.

Retrieves the count of Posts from the last 7 days matching a search query.

Retrieves a list of Users who liked a specific Post by its ID.

Retrieves a list of Posts that quote a specific Post by its ID.

Retrieves a list of Users who reposted a specific Post by its ID.

Retrieves a list of Posts that repost a specific Post by its ID.

Retrieves the count of rules in the active rule set for the filtered stream.

Retrieves the active rule set or a subset of rules for the filtered stream.

Retrieves a list of Users who purchased tickets to a specific Space by its ID.

Retrieves details of Spaces created by specified User IDs.

Retrieves details of a specific space by its ID.

Retrieves details of multiple Spaces by their IDs.

Retrieves a list of Posts shared in a specific Space by its ID.

Retrieves trending topics for a specific location identified by its WOEID.

Retrieves personalized trending topics for the authenticated user.

Retrieves usage statistics for Posts over a specified number of days.

Retrieves a list of Users who are affiliated with a specific organization User by their ID.

Retrieves a list of Users blocked by the specified User ID.

Retrieves a list of Bookmark folders created by the authenticated user.

Retrieves a list of Posts bookmarked by the authenticated user.

Retrieves Posts in a specific Bookmark folder by its ID for the authenticated user.

Retrieves details of a specific User by their ID.

Retrieves details of multiple Users by their IDs.

Retrieves details of a specific User by their username.

Retrieves details of multiple Users by their usernames.

Retrieves a list of Lists followed by a specific User by their ID.

Retrieves a list of Users who follow a specific User by their ID.

Retrieves a list of Users followed by a specific User by their ID.

Retrieves a list of Posts liked by a specific User by their ID.

Retrieves a list of Lists that a specific User is a member of by their ID.

Retrieves details of the authenticated user.

Retrieves a list of Posts that mention a specific User by their ID.

Retrieves a list of Users muted by the authenticated user.

Retrieves a list of Lists owned by a specific User by their ID.

Retrieves a list of Lists pinned by the authenticated user.

Retrieves a list of posts authored by a specific User by their ID.

Returns the public keys and Juicebox configuration for the specified user.

Returns the public keys and Juicebox configuration for the specified users.

Retrieves a list of Posts that repost content from the authenticated user.

Retrieves a reverse chronological list of Posts in the authenticated User’s Timeline.

Get a list of webhook configs associated with a client app.

Get a list of webhook links associated with a filtered stream ruleset.

Hides or unhides a reply to a conversation owned by the authenticated user.

Initializes a new XChat group conversation and returns a unique conversation ID. This endpoint is the first step in creating a group chat. The returned conversation_id should be used in subsequent calls to POST /chat/conversations/group to fully create and configure the group with members, admins, encryption keys, and other settings. **Workflow:** 1. Call this endpoint to get a `conversation_id` 2. Use that `conversation_id` when calling `POST /chat/conversations/group` to create the group **Authentication:** - Requires OAuth 1.0a User Context or OAuth 2.0 User Context - Required scope: `dm.write`

Initializes a media upload.

Causes the authenticated user to Like a specific Post by its ID.

Marks a specific Chat conversation as read on behalf of the authenticated user. For 1:1 conversations, provide the recipient's user ID; the server constructs the canonical conversation ID from the authenticated user and recipient.

Uploads a media file for use in posts or other content.

Causes the authenticated user to mute a specific User by their ID.

Causes the authenticated user to pin a specific List by its ID.

Removes a User from a specific List by its ID and the User’s ID.

Causes the authenticated user to repost a specific Post by its ID.

Retrieves a list of Communities matching the specified search query.

Returns all the community notes written by the user.

Returns all the posts that are eligible for community notes.

Retrieves a list of News stories matching the specified search query.

Retrieves Posts from the full archive matching a search query.

Retrieves Posts from the last 7 days matching a search query.

Retrieves a list of Spaces matching the specified search query.

Retrieves a list of Users matching a search query.

Sends an encrypted message to a specific Chat conversation. For 1:1 conversations, provide the recipient's user ID; the server constructs the canonical conversation ID from the authenticated user and recipient.

Sends a typing indicator to a specific Chat conversation on behalf of the authenticated user. For 1:1 conversations, provide the recipient's user ID; the server constructs the canonical conversation ID from the authenticated user and recipient.

Streams all labeling events applied to Posts.

Streams all compliance data related to Likes for Users.

Streams all public Likes in real-time.

Streams a 10% sample of public Likes in real-time.

Streams Posts in real-time matching the active rule set.

Streams all compliance data related to Posts.

Streams all public Posts in real-time.

Streams all public English-language Posts in real-time.

Streams all public Japanese-language Posts in real-time.

Streams all public Korean-language Posts in real-time.

Streams all public Portuguese-language Posts in real-time.

Streams a 1% sample of public Posts in real-time.

Streams a 10% sample of public Posts in real-time.

Streams all compliance data related to Users.

Unblocks direct messages to or from a specific User by their ID for the authenticated user.

Causes the authenticated user to unfollow a specific List by its ID.

Causes the authenticated user to unfollow a specific user by their ID.

Causes the authenticated user to Unlike a specific Post by its ID.

Causes the authenticated user to unmute a specific user by their ID.

Causes the authenticated user to unpin a specific List by its ID.

Causes the authenticated user to unrepost a specific Post by its ID.

Updates a subscription for an X activity event

Updates the details of a specific List owned by the authenticated user by its ID.

Adds or deletes rules from the active rule set for the filtered stream.

Checks a user’s Account Activity subscription for a given webhook.

Triggers a CRC check for a given webhook.