{ "info": { "_postman_id": "e7f4fd10-d5b7-4b7d-94a3-dd5144bb2998", "name": "X API v2 Account Activity Chat API", "description": "X API v2 available endpoints\n\nContact Support:\n Name: X Developers", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:21:17.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "lastUpdatedBy": "35240", "uid": "35240-e7f4fd10-d5b7-4b7d-94a3-dd5144bb2998" }, "item": [ { "name": "2", "item": [ { "name": "chat", "item": [ { "name": "conversations", "item": [ { "name": "group", "item": [ { "name": "initialize", "item": [ { "name": "Initialize Chat Group", "id": "91fadc9c-c28a-40f3-a7ed-9ddf08307da7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/group/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group", "initialize" ] }, "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" }, "response": [ { "id": "e315ff85-7a7c-4247-873e-28db22ab821b", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/group/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group", "initialize" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"conversation_id\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e315ff85-7a7c-4247-873e-28db22ab821b" }, { "id": "a6d9dfc0-5fba-4de6-808f-4275baa7822b", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/group/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group", "initialize" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-a6d9dfc0-5fba-4de6-808f-4275baa7822b" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-91fadc9c-c28a-40f3-a7ed-9ddf08307da7" } ], "id": "3779bc4c-a6bc-41de-82f2-f7a44b89d6d7", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-3779bc4c-a6bc-41de-82f2-f7a44b89d6d7" }, { "name": "Create Chat Group Conversation", "id": "6aea36d9-576c-4c46-822b-96c98b0c4b15", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"group_members\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"zC3\",\n \"message_event_signature\": {\n \"signature\": \"b8Cg3+QVk73\",\n \"public_key_version\": \"455530265\",\n \"signature_version\": \"964235\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"mUgFE-E\",\n \"message_event_signature\": {\n \"signature\": \"dlc\",\n \"public_key_version\": \"05239\",\n \"signature_version\": \"7864467\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\",\n \"group_admins\": [\n \"\",\n \"\"\n ],\n \"group_avatar_url\": \"\",\n \"group_description\": \"\",\n \"group_name\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/group", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group" ] }, "description": "Creates a new encrypted Chat group conversation on behalf of the authenticated user." }, "response": [ { "id": "65f2f5cc-c6f4-446d-8eb2-d5acc4f2dfd0", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"group_members\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"zC3\",\n \"message_event_signature\": {\n \"signature\": \"b8Cg3+QVk73\",\n \"public_key_version\": \"455530265\",\n \"signature_version\": \"964235\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"mUgFE-E\",\n \"message_event_signature\": {\n \"signature\": \"dlc\",\n \"public_key_version\": \"05239\",\n \"signature_version\": \"7864467\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\",\n \"group_admins\": [\n \"\",\n \"\"\n ],\n \"group_avatar_url\": \"\",\n \"group_description\": \"\",\n \"group_name\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/group", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"conversation_id\": \"\",\n \"conversation_key_change_sequence_id\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-65f2f5cc-c6f4-446d-8eb2-d5acc4f2dfd0" }, { "id": "9150b509-61c4-419f-a6ae-f06d300dc4da", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"group_members\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"zC3\",\n \"message_event_signature\": {\n \"signature\": \"b8Cg3+QVk73\",\n \"public_key_version\": \"455530265\",\n \"signature_version\": \"964235\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"mUgFE-E\",\n \"message_event_signature\": {\n \"signature\": \"dlc\",\n \"public_key_version\": \"05239\",\n \"signature_version\": \"7864467\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\",\n \"group_admins\": [\n \"\",\n \"\"\n ],\n \"group_avatar_url\": \"\",\n \"group_description\": \"\",\n \"group_name\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/group", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", "group" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-9150b509-61c4-419f-a6ae-f06d300dc4da" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-6aea36d9-576c-4c46-822b-96c98b0c4b15" } ], "id": "60e5df17-2d32-4230-a2e8-07c3bbd998bc", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-60e5df17-2d32-4230-a2e8-07c3bbd998bc" }, { "name": "{id}", "item": [ { "name": "events", "item": [ { "name": "Get Chat Conversation Events", "id": "40d39e68-8a21-4711-8754-fffcdfef0b53", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/events?max_results=10&pagination_token=&chat_message_event.fields=sender_id", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "events" ], "query": [ { "description": "Maximum number of message events to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatMessageEvent fields to display.", "key": "chat_message_event.fields", "value": "sender_id" } ], "variable": [ { "id": "3e3e49a1-dfbb-4e3e-bf1f-964384db2aa7", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." } ] }, "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." }, "response": [ { "id": "ef75f907-0a59-456a-90d1-83b87f5abfa5", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/events?max_results=10&pagination_token=&chat_message_event.fields=sender_id", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "events" ], "query": [ { "description": "Maximum number of message events to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatMessageEvent fields to display.", "key": "chat_message_event.fields", "value": "sender_id" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"encoded_event\": \"\",\n \"conversation_id\": \"\",\n \"conversation_token\": \"\",\n \"created_at_msec\": \"\",\n \"id\": \"\",\n \"is_trusted\": \"\",\n \"message_event_signature\": {\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"public_key_version\": \"\",\n \"signature\": \"\",\n \"signature_version\": \"\",\n \"signing_public_key\": \"\"\n },\n \"previous_sequence_id\": \"\",\n \"sender_id\": \"\",\n \"sequence_id\": \"\"\n },\n {\n \"encoded_event\": \"\",\n \"conversation_id\": \"\",\n \"conversation_token\": \"\",\n \"created_at_msec\": \"\",\n \"id\": \"\",\n \"is_trusted\": \"\",\n \"message_event_signature\": {\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"public_key_version\": \"\",\n \"signature\": \"\",\n \"signature_version\": \"\",\n \"signing_public_key\": \"\"\n },\n \"previous_sequence_id\": \"\",\n \"sender_id\": \"\",\n \"sequence_id\": \"\"\n }\n ],\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ],\n \"meta\": {\n \"conversation_key_events\": [\n \"\",\n \"\"\n ],\n \"has_more\": \"\",\n \"next_token\": \"\",\n \"result_count\": \"\"\n }\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-ef75f907-0a59-456a-90d1-83b87f5abfa5" }, { "id": "cc9b9ae6-d035-442d-9042-6eac11315b22", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/events?max_results=10&pagination_token=&chat_message_event.fields=sender_id", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "events" ], "query": [ { "description": "Maximum number of message events to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatMessageEvent fields to display.", "key": "chat_message_event.fields", "value": "sender_id" } ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-cc9b9ae6-d035-442d-9042-6eac11315b22" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-40d39e68-8a21-4711-8754-fffcdfef0b53" } ], "id": "8fb3e79c-2395-4625-9d90-ee20d56c8874", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8fb3e79c-2395-4625-9d90-ee20d56c8874" }, { "name": "keys", "item": [ { "name": "Add Conversation Keys", "id": "31a59aea-8717-46d4-ad71-5a347da54892", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"TDtuzDHC2v\",\n \"message_event_signature\": {\n \"signature\": \"t2a\",\n \"public_key_version\": \"363\",\n \"signature_version\": \"6\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"3r//\",\n \"message_event_signature\": {\n \"signature\": \"n5izj9BFG7E\",\n \"public_key_version\": \"71917\",\n \"signature_version\": \"1\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "keys" ], "variable": [ { "id": "2916427c-e51d-4f11-959d-b12d8d078c1b", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." } ] }, "description": "Adds (initializes or rotates) the encryption keys for a Chat conversation.\nCall this before sending messages in a new 1:1 conversation, and again with a\nnewer key version to rotate the conversation key.\n\nFor 1:1 conversations, provide the recipient's user ID as the conversation_id.\nThe server constructs the canonical conversation ID from the authenticated user\nand recipient.\n\nThe request body must contain the conversation key version and participant keys\n(the conversation key encrypted for each participant using their public key).\n\n**Workflow (new 1:1 conversation):**\n1. Generate a conversation key using the SDK\n2. Encrypt the key for both participants using their public keys\n3. Call this endpoint to register the keys\n4. Send messages using `POST /chat/conversations/{id}/messages`\n\nTo rotate the keys of an existing conversation, repeat the same call with a\nnewer conversation key version.\n\n**Authentication:**\n- Requires OAuth 1.0a User Context or OAuth 2.0 User Context\n- Required scopes: `tweet.read`, `users.read`, `dm.write`\n" }, "response": [ { "id": "72cd0e03-470e-45fb-bb39-37060d3a66e1", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"TDtuzDHC2v\",\n \"message_event_signature\": {\n \"signature\": \"t2a\",\n \"public_key_version\": \"363\",\n \"signature_version\": \"6\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"3r//\",\n \"message_event_signature\": {\n \"signature\": \"n5izj9BFG7E\",\n \"public_key_version\": \"71917\",\n \"signature_version\": \"1\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "keys" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"conversation_id\": \"\",\n \"sequence_id\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-72cd0e03-470e-45fb-bb39-37060d3a66e1" }, { "id": "e01698a8-88f4-4e42-af54-2cd9870151bf", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"TDtuzDHC2v\",\n \"message_event_signature\": {\n \"signature\": \"t2a\",\n \"public_key_version\": \"363\",\n \"signature_version\": \"6\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"3r//\",\n \"message_event_signature\": {\n \"signature\": \"n5izj9BFG7E\",\n \"public_key_version\": \"71917\",\n \"signature_version\": \"1\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"base64_encoded_key_rotation\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "keys" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e01698a8-88f4-4e42-af54-2cd9870151bf" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-31a59aea-8717-46d4-ad71-5a347da54892" } ], "id": "0a1fcb2a-db4e-400c-8657-c20ce10d6174", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-0a1fcb2a-db4e-400c-8657-c20ce10d6174" }, { "name": "members", "item": [ { "name": "Add members to a Chat group conversation", "id": "6f005ea1-6322-4e30-9009-15d7468f332e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"B\",\n \"message_event_signature\": {\n \"signature\": \"5gUsfMohDjF\",\n \"public_key_version\": \"8\",\n \"signature_version\": \"34317227258\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"bnT\",\n \"message_event_signature\": {\n \"signature\": \"X2\",\n \"public_key_version\": \"6\",\n \"signature_version\": \"99\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"encrypted_avatar_url\": \"\",\n \"encrypted_title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "members" ], "variable": [ { "id": "1f5b0272-9bca-4077-8551-d0909da7c762", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The Chat group conversation ID (prefixed with 'g')." } ] }, "description": "Adds one or more members to an existing encrypted Chat group conversation, rotating the conversation key." }, "response": [ { "id": "f7d52529-1abc-4705-926a-6b38af55757a", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"B\",\n \"message_event_signature\": {\n \"signature\": \"5gUsfMohDjF\",\n \"public_key_version\": \"8\",\n \"signature_version\": \"34317227258\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"bnT\",\n \"message_event_signature\": {\n \"signature\": \"X2\",\n \"public_key_version\": \"6\",\n \"signature_version\": \"99\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"encrypted_avatar_url\": \"\",\n \"encrypted_title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "members" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"conversation_key_change_sequence_id\": \"\",\n \"current_member_ids\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f7d52529-1abc-4705-926a-6b38af55757a" }, { "id": "495b886b-4d7f-4d73-a569-4a30f924b33c", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"user_ids\": [\n \"\",\n \"\"\n ],\n \"action_signatures\": [\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"B\",\n \"message_event_signature\": {\n \"signature\": \"5gUsfMohDjF\",\n \"public_key_version\": \"8\",\n \"signature_version\": \"34317227258\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n },\n {\n \"message_id\": \"\",\n \"encoded_message_event_detail\": \"bnT\",\n \"message_event_signature\": {\n \"signature\": \"X2\",\n \"public_key_version\": \"6\",\n \"signature_version\": \"99\",\n \"message_signing_key_info_list\": [\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n {\n \"member_id\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"signing_public_key\": \"\"\n },\n \"signature_payload\": \"\"\n }\n ],\n \"conversation_key_version\": \"\",\n \"conversation_participant_keys\": [\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n },\n {\n \"encrypted_conversation_key\": \"\",\n \"public_key_version\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"encrypted_avatar_url\": \"\",\n \"encrypted_title\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "members" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-495b886b-4d7f-4d73-a569-4a30f924b33c" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-6f005ea1-6322-4e30-9009-15d7468f332e" } ], "id": "29f76db0-7081-45f2-9ac4-81cd46030087", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-29f76db0-7081-45f2-9ac4-81cd46030087" }, { "name": "messages", "item": [ { "name": "Send Chat Message", "id": "83eede54-4997-416e-81a5-5e2d7c2799dc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"message_id\": \"\",\n \"encoded_message_create_event\": \"\",\n \"conversation_token\": \"\",\n \"encoded_message_event_signature\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/messages", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "messages" ], "variable": [ { "id": "7690c9e7-573f-4d1c-a2fd-cda107fc9554", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." } ] }, "description": "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." }, "response": [ { "id": "bcee887b-6a28-46d9-8ade-7c3fd9026cea", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"message_id\": \"\",\n \"encoded_message_create_event\": \"\",\n \"conversation_token\": \"\",\n \"encoded_message_event_signature\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/messages", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "messages" ], "variable": [ { "key": "id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"encoded_message_event\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-bcee887b-6a28-46d9-8ade-7c3fd9026cea" }, { "id": "e805b33a-c1c6-4f24-84cf-1533bf12fc9d", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"message_id\": \"\",\n \"encoded_message_create_event\": \"\",\n \"conversation_token\": \"\",\n \"encoded_message_event_signature\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/messages", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "messages" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e805b33a-c1c6-4f24-84cf-1533bf12fc9d" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-83eede54-4997-416e-81a5-5e2d7c2799dc" } ], "id": "67c60316-bc73-4488-9e5c-a6467c698f8c", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-67c60316-bc73-4488-9e5c-a6467c698f8c" }, { "name": "read", "item": [ { "name": "Mark Conversation as Read", "id": "89936145-9dcb-4cc4-b81d-2ae6a9ae11c5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"seen_until_sequence_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/read", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "read" ], "variable": [ { "id": "660ae80c-1306-46b3-b9dd-ebf53e8e5fb7", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." } ] }, "description": "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." }, "response": [ { "id": "aec4686e-55cc-4fbe-adf2-d396ba6c3ec6", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"seen_until_sequence_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/read", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "read" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"success\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-aec4686e-55cc-4fbe-adf2-d396ba6c3ec6" }, { "id": "3b300788-5dd5-4555-be6d-27f857b33512", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"seen_until_sequence_id\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/read", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "read" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-3b300788-5dd5-4555-be6d-27f857b33512" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-89936145-9dcb-4cc4-b81d-2ae6a9ae11c5" } ], "id": "6d365c73-b724-46cb-9e28-98ab2670a50b", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-6d365c73-b724-46cb-9e28-98ab2670a50b" }, { "name": "typing", "item": [ { "name": "Send Typing Indicator", "id": "d1341ba5-684c-4e9b-abf5-c05018ebdd29", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/typing", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "typing" ], "variable": [ { "id": "121772e0-9b0f-4c10-be62-6f243cae49de", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." } ] }, "description": "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." }, "response": [ { "id": "8d16490d-8e45-4097-81c4-9fe12194ce38", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/typing", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "typing" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"success\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8d16490d-8e45-4097-81c4-9fe12194ce38" }, { "id": "d67e4dd9-eb9c-4be9-93ad-d07c25b0bad2", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id/typing", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id", "typing" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-d67e4dd9-eb9c-4be9-93ad-d07c25b0bad2" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-d1341ba5-684c-4e9b-abf5-c05018ebdd29" } ], "id": "e9ee717f-dc32-4566-9d76-3d8f3e7cfeb1", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e9ee717f-dc32-4566-9d76-3d8f3e7cfeb1" }, { "name": "Get Chat Conversation", "id": "6e8aaa64-c469-4cfd-91db-138c9ad24052", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id?chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id" ], "query": [ { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ], "variable": [ { "id": "8ed1296a-9289-49c9-b7bf-008f441a6be6", "key": "id", "value": "", "description": "(Required) The conversation ID. For 1:1 conversations, use the recipient user ID or dash-separated canonical ID. For group conversations, use the group ID (prefixed with 'g')." } ] }, "description": "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." }, "response": [ { "id": "396ad0ad-dc0f-4dc3-81b2-d141c0ab1e90", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id?chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id" ], "query": [ { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"admin_ids\": [\n \"\"\n ],\n \"created_at\": \"\",\n \"group_avatar_url\": \"\",\n \"group_name\": \"\",\n \"is_muted\": \"\",\n \"member_ids\": [\n \"\"\n ],\n \"message_ttl_msec\": \"\",\n \"participant_ids\": [\n \"\"\n ],\n \"screen_capture_blocking_enabled\": \"\",\n \"screen_capture_detection_enabled\": \"\",\n \"type\": \"group\",\n \"updated_at\": \"\"\n }\n ],\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ],\n \"includes\": {\n \"media\": [\n {\n \"type\": \"\",\n \"height\": \"\",\n \"media_key\": \"16_5476\",\n \"width\": \"\"\n }\n ],\n \"places\": [\n {\n \"id\": \"\",\n \"full_name\": \"\",\n \"contained_within\": [\n \"\"\n ],\n \"country\": \"\",\n \"country_code\": \"KM\",\n \"geo\": {\n \"type\": \"Feature\",\n \"bbox\": [\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"properties\": {},\n \"geometry\": {\n \"type\": \"Point\",\n \"coordinates\": [\n \"\",\n \"\"\n ]\n }\n },\n \"name\": \"\",\n \"place_type\": \"unknown\"\n }\n ],\n \"polls\": [\n {\n \"id\": \"04649\",\n \"options\": [\n {\n \"position\": \"\",\n \"label\": \"\",\n \"votes\": \"\"\n },\n {\n \"position\": \"\",\n \"label\": \"\",\n \"votes\": \"\"\n }\n ],\n \"duration_minutes\": \"\",\n \"end_datetime\": \"\",\n \"voting_status\": \"open\"\n }\n ],\n \"topics\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\"\n }\n ],\n \"tweets\": [\n {\n \"attachments\": {\n \"media_keys\": [\n \"9979540_3190056799\"\n ],\n \"media_source_tweet_id\": [\n \"535185\"\n ],\n \"poll_ids\": [\n \"5067720564151\"\n ]\n },\n \"author_id\": \"77671332114424\",\n \"community_id\": \"2\",\n \"context_annotations\": [\n {\n \"domain\": {\n \"id\": \"6317773\",\n \"description\": \"\",\n \"name\": \"\"\n },\n \"entity\": {\n \"id\": \"155118241707902\",\n \"description\": \"\",\n \"name\": \"\"\n }\n }\n ],\n \"conversation_id\": \"13330583298885737\",\n \"created_at\": \"\",\n \"display_text_range\": [\n \"\",\n \"\"\n ],\n \"edit_controls\": {\n \"is_edit_eligible\": \"\",\n \"editable_until\": \"\",\n \"edits_remaining\": \"\"\n },\n \"edit_history_tweet_ids\": [\n \"633352557266\"\n ],\n \"entities\": {\n \"annotations\": [\n {\n \"start\": \"\",\n \"end\": \"\",\n \"normalized_text\": \"\",\n \"probability\": \"\",\n \"type\": \"\"\n }\n ],\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"3WMY44okzj0u\",\n \"id\": \"5927691080644532\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"6988_85029298\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"geo\": {\n \"coordinates\": {\n \"type\": \"Point\",\n \"coordinates\": [\n \"\",\n \"\"\n ]\n },\n \"place_id\": \"\"\n },\n \"id\": \"440689464583202737\",\n \"in_reply_to_user_id\": \"2346947023510527305\",\n \"lang\": \"\",\n \"matched_media_notes\": {\n \"match_status\": \"\",\n \"note_id\": \"516434\"\n },\n \"non_public_metrics\": {\n \"impression_count\": \"\"\n },\n \"note_request_suggestions\": {\n \"source_link\": {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"202_31093\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n },\n \"suggestion\": \"\",\n \"suggestion_id\": \"\"\n },\n \"note_tweet\": {\n \"entities\": {\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"NJ3ugbBQprORpo\",\n \"id\": \"603439\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"0957827_78\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"text\": \"\"\n },\n \"organic_metrics\": {\n \"impression_count\": \"\",\n \"retweet_count\": \"\",\n \"reply_count\": \"\",\n \"like_count\": \"\"\n },\n \"paid_partnership\": \"\",\n \"possibly_sensitive\": \"\",\n \"promoted_metrics\": {\n \"impression_count\": \"\",\n \"like_count\": \"\",\n \"reply_count\": \"\",\n \"retweet_count\": \"\"\n },\n \"public_metrics\": {\n \"retweet_count\": \"\",\n \"reply_count\": \"\",\n \"like_count\": \"\",\n \"impression_count\": \"\",\n \"bookmark_count\": \"\",\n \"quote_count\": \"\"\n },\n \"referenced_tweets\": [\n {\n \"type\": \"quoted\",\n \"id\": \"14426314622\"\n }\n ],\n \"reply_settings\": \"everyone\",\n \"scopes\": {\n \"followers\": \"\"\n },\n \"source\": \"\",\n \"suggested_source_links\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"25_2173\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ],\n \"suggested_source_links_with_counts\": {\n \"count\": \"\",\n \"url\": {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"8182851_23717665601\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n },\n \"text\": \"\",\n \"username\": \"_ZXnnIF4fP\",\n \"withheld\": {\n \"copyright\": \"\",\n \"country_codes\": [\n \"PJ\"\n ],\n \"scope\": \"user\"\n }\n }\n ],\n \"users\": [\n {\n \"id\": \"35\",\n \"name\": \"\",\n \"username\": \"ShrA2busKn\",\n \"affiliation\": {\n \"badge_url\": \"\",\n \"description\": \"\",\n \"url\": \"\",\n \"user_id\": [\n \"4215803595538978625\"\n ]\n },\n \"connection_status\": [\n \"muting\"\n ],\n \"created_at\": \"\",\n \"description\": \"\",\n \"entities\": {\n \"description\": {\n \"annotations\": [\n {\n \"start\": \"\",\n \"end\": \"\",\n \"normalized_text\": \"\",\n \"probability\": \"\",\n \"type\": \"\"\n }\n ],\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"i3ejRD7ntLHz5nT\",\n \"id\": \"1071653349\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"858082488_30\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"url\": {\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"4_5030\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n }\n },\n \"location\": \"\",\n \"most_recent_tweet_id\": \"2806921350704283\",\n \"pinned_tweet_id\": \"4825007291\",\n \"profile_banner_url\": \"\",\n \"profile_image_url\": \"\",\n \"protected\": \"\",\n \"public_metrics\": {\n \"followers_count\": \"\",\n \"following_count\": \"\",\n \"tweet_count\": \"\",\n \"listed_count\": \"\",\n \"like_count\": \"\"\n },\n \"receives_your_dm\": \"\",\n \"subscription_type\": \"None\",\n \"url\": \"\",\n \"verified\": \"\",\n \"verified_type\": \"blue\",\n \"withheld\": {\n \"country_codes\": [\n \"QR\"\n ],\n \"scope\": \"user\"\n }\n }\n ]\n },\n \"meta\": {\n \"has_message_requests\": \"\",\n \"has_more\": \"\",\n \"next_token\": \"\",\n \"result_count\": \"\"\n }\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-396ad0ad-dc0f-4dc3-81b2-d141c0ab1e90" }, { "id": "113a8b2e-6fc5-4710-8dc1-4d1bb178faf1", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations/:id?chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations", ":id" ], "query": [ { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-113a8b2e-6fc5-4710-8dc1-4d1bb178faf1" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-6e8aaa64-c469-4cfd-91db-138c9ad24052" } ], "id": "2c291f12-21da-46fa-9eff-f5ed5f12bb9c", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-2c291f12-21da-46fa-9eff-f5ed5f12bb9c" }, { "name": "Get Chat Conversations", "id": "8bbff209-3fb1-4cca-a0fb-d31f703d6906", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations?max_results=10&pagination_token=&chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations" ], "query": [ { "description": "Maximum number of conversations to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ] }, "description": "Retrieves a list of Chat conversations for the authenticated user's inbox." }, "response": [ { "id": "45378690-a67f-49d8-a967-8e2c418f46e4", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations?max_results=10&pagination_token=&chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations" ], "query": [ { "description": "Maximum number of conversations to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"admin_ids\": [\n \"\"\n ],\n \"created_at\": \"\",\n \"group_avatar_url\": \"\",\n \"group_name\": \"\",\n \"is_muted\": \"\",\n \"member_ids\": [\n \"\"\n ],\n \"message_ttl_msec\": \"\",\n \"participant_ids\": [\n \"\"\n ],\n \"screen_capture_blocking_enabled\": \"\",\n \"screen_capture_detection_enabled\": \"\",\n \"type\": \"group\",\n \"updated_at\": \"\"\n }\n ],\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ],\n \"includes\": {\n \"media\": [\n {\n \"type\": \"\",\n \"height\": \"\",\n \"media_key\": \"16_5476\",\n \"width\": \"\"\n }\n ],\n \"places\": [\n {\n \"id\": \"\",\n \"full_name\": \"\",\n \"contained_within\": [\n \"\"\n ],\n \"country\": \"\",\n \"country_code\": \"KM\",\n \"geo\": {\n \"type\": \"Feature\",\n \"bbox\": [\n \"\",\n \"\",\n \"\",\n \"\"\n ],\n \"properties\": {},\n \"geometry\": {\n \"type\": \"Point\",\n \"coordinates\": [\n \"\",\n \"\"\n ]\n }\n },\n \"name\": \"\",\n \"place_type\": \"unknown\"\n }\n ],\n \"polls\": [\n {\n \"id\": \"04649\",\n \"options\": [\n {\n \"position\": \"\",\n \"label\": \"\",\n \"votes\": \"\"\n },\n {\n \"position\": \"\",\n \"label\": \"\",\n \"votes\": \"\"\n }\n ],\n \"duration_minutes\": \"\",\n \"end_datetime\": \"\",\n \"voting_status\": \"open\"\n }\n ],\n \"topics\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\"\n }\n ],\n \"tweets\": [\n {\n \"attachments\": {\n \"media_keys\": [\n \"9979540_3190056799\"\n ],\n \"media_source_tweet_id\": [\n \"535185\"\n ],\n \"poll_ids\": [\n \"5067720564151\"\n ]\n },\n \"author_id\": \"77671332114424\",\n \"community_id\": \"2\",\n \"context_annotations\": [\n {\n \"domain\": {\n \"id\": \"6317773\",\n \"description\": \"\",\n \"name\": \"\"\n },\n \"entity\": {\n \"id\": \"155118241707902\",\n \"description\": \"\",\n \"name\": \"\"\n }\n }\n ],\n \"conversation_id\": \"13330583298885737\",\n \"created_at\": \"\",\n \"display_text_range\": [\n \"\",\n \"\"\n ],\n \"edit_controls\": {\n \"is_edit_eligible\": \"\",\n \"editable_until\": \"\",\n \"edits_remaining\": \"\"\n },\n \"edit_history_tweet_ids\": [\n \"633352557266\"\n ],\n \"entities\": {\n \"annotations\": [\n {\n \"start\": \"\",\n \"end\": \"\",\n \"normalized_text\": \"\",\n \"probability\": \"\",\n \"type\": \"\"\n }\n ],\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"3WMY44okzj0u\",\n \"id\": \"5927691080644532\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"6988_85029298\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"geo\": {\n \"coordinates\": {\n \"type\": \"Point\",\n \"coordinates\": [\n \"\",\n \"\"\n ]\n },\n \"place_id\": \"\"\n },\n \"id\": \"440689464583202737\",\n \"in_reply_to_user_id\": \"2346947023510527305\",\n \"lang\": \"\",\n \"matched_media_notes\": {\n \"match_status\": \"\",\n \"note_id\": \"516434\"\n },\n \"non_public_metrics\": {\n \"impression_count\": \"\"\n },\n \"note_request_suggestions\": {\n \"source_link\": {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"202_31093\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n },\n \"suggestion\": \"\",\n \"suggestion_id\": \"\"\n },\n \"note_tweet\": {\n \"entities\": {\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"NJ3ugbBQprORpo\",\n \"id\": \"603439\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"0957827_78\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"text\": \"\"\n },\n \"organic_metrics\": {\n \"impression_count\": \"\",\n \"retweet_count\": \"\",\n \"reply_count\": \"\",\n \"like_count\": \"\"\n },\n \"paid_partnership\": \"\",\n \"possibly_sensitive\": \"\",\n \"promoted_metrics\": {\n \"impression_count\": \"\",\n \"like_count\": \"\",\n \"reply_count\": \"\",\n \"retweet_count\": \"\"\n },\n \"public_metrics\": {\n \"retweet_count\": \"\",\n \"reply_count\": \"\",\n \"like_count\": \"\",\n \"impression_count\": \"\",\n \"bookmark_count\": \"\",\n \"quote_count\": \"\"\n },\n \"referenced_tweets\": [\n {\n \"type\": \"quoted\",\n \"id\": \"14426314622\"\n }\n ],\n \"reply_settings\": \"everyone\",\n \"scopes\": {\n \"followers\": \"\"\n },\n \"source\": \"\",\n \"suggested_source_links\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"25_2173\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ],\n \"suggested_source_links_with_counts\": {\n \"count\": \"\",\n \"url\": {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"8182851_23717665601\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n },\n \"text\": \"\",\n \"username\": \"_ZXnnIF4fP\",\n \"withheld\": {\n \"copyright\": \"\",\n \"country_codes\": [\n \"PJ\"\n ],\n \"scope\": \"user\"\n }\n }\n ],\n \"users\": [\n {\n \"id\": \"35\",\n \"name\": \"\",\n \"username\": \"ShrA2busKn\",\n \"affiliation\": {\n \"badge_url\": \"\",\n \"description\": \"\",\n \"url\": \"\",\n \"user_id\": [\n \"4215803595538978625\"\n ]\n },\n \"connection_status\": [\n \"muting\"\n ],\n \"created_at\": \"\",\n \"description\": \"\",\n \"entities\": {\n \"description\": {\n \"annotations\": [\n {\n \"start\": \"\",\n \"end\": \"\",\n \"normalized_text\": \"\",\n \"probability\": \"\",\n \"type\": \"\"\n }\n ],\n \"cashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"hashtags\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"tag\": \"\"\n }\n ],\n \"mentions\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"username\": \"i3ejRD7ntLHz5nT\",\n \"id\": \"1071653349\"\n }\n ],\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"858082488_30\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n },\n \"url\": {\n \"urls\": [\n {\n \"end\": \"\",\n \"start\": \"\",\n \"url\": \"\",\n \"description\": \"\",\n \"display_url\": \"\",\n \"expanded_url\": \"\",\n \"images\": [\n {\n \"height\": \"\",\n \"url\": \"\",\n \"width\": \"\"\n }\n ],\n \"media_key\": \"4_5030\",\n \"status\": \"\",\n \"title\": \"\",\n \"unwound_url\": \"\"\n }\n ]\n }\n },\n \"location\": \"\",\n \"most_recent_tweet_id\": \"2806921350704283\",\n \"pinned_tweet_id\": \"4825007291\",\n \"profile_banner_url\": \"\",\n \"profile_image_url\": \"\",\n \"protected\": \"\",\n \"public_metrics\": {\n \"followers_count\": \"\",\n \"following_count\": \"\",\n \"tweet_count\": \"\",\n \"listed_count\": \"\",\n \"like_count\": \"\"\n },\n \"receives_your_dm\": \"\",\n \"subscription_type\": \"None\",\n \"url\": \"\",\n \"verified\": \"\",\n \"verified_type\": \"blue\",\n \"withheld\": {\n \"country_codes\": [\n \"QR\"\n ],\n \"scope\": \"user\"\n }\n }\n ]\n },\n \"meta\": {\n \"has_message_requests\": \"\",\n \"has_more\": \"\",\n \"next_token\": \"\",\n \"result_count\": \"\"\n }\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-45378690-a67f-49d8-a967-8e2c418f46e4" }, { "id": "8811e90e-45eb-4eb3-a0f1-7669b8a0e7ad", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/conversations?max_results=10&pagination_token=&chat_conversation.fields=is_muted&expansions=participant_ids&user.fields=name", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "conversations" ], "query": [ { "description": "Maximum number of conversations to return.", "key": "max_results", "value": "10" }, { "description": "Token for pagination to retrieve the next page of results.", "key": "pagination_token", "value": "" }, { "description": "A comma separated list of ChatConversation fields to display.", "key": "chat_conversation.fields", "value": "is_muted" }, { "description": "A comma separated list of fields to expand.", "key": "expansions", "value": "participant_ids" }, { "description": "A comma separated list of User fields to display.", "key": "user.fields", "value": "name" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8811e90e-45eb-4eb3-a0f1-7669b8a0e7ad" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8bbff209-3fb1-4cca-a0fb-d31f703d6906" } ], "id": "6d6fe0a9-c186-4903-9127-9105f2e4603e", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-6d6fe0a9-c186-4903-9127-9105f2e4603e" }, { "name": "media", "item": [ { "name": "upload", "item": [ { "name": "initialize", "item": [ { "name": "Initialize Chat Media Upload", "id": "0fc13393-b480-4e16-bdf1-fcd320087f6c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"total_bytes\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", "initialize" ] }, "description": "Initializes an XChat media upload session." }, "response": [ { "id": "e4dbbf71-9ae0-47ca-99cf-4ed695390484", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"total_bytes\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", "initialize" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"session_id\": \"\",\n \"media_hash_key\": \"\",\n \"conversation_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e4dbbf71-9ae0-47ca-99cf-4ed695390484" }, { "id": "4d4277df-6a9d-4d2e-82d2-1245eb1f7fd7", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"total_bytes\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/initialize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", "initialize" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-4d4277df-6a9d-4d2e-82d2-1245eb1f7fd7" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-0fc13393-b480-4e16-bdf1-fcd320087f6c" } ], "id": "cf194d47-83cf-4820-ba66-36aacd759999", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-cf194d47-83cf-4820-ba66-36aacd759999" }, { "name": "{id}", "item": [ { "name": "append", "item": [ { "name": "Append Chat Media Upload", "id": "0d41a7eb-69f3-4f5f-b996-25b5f22e0009", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"media\": \"\",\n \"segment_index\": \"\",\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/append", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "append" ], "variable": [ { "id": "0867f6c1-3454-4f16-adcb-ec569359eb2e", "key": "id", "value": "", "description": "(Required) The session/resume id from initialize." } ] }, "description": "Appends media data to an XChat upload session." }, "response": [ { "id": "5c061d2a-c25a-42ef-b385-457315b9e641", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"media\": \"\",\n \"segment_index\": \"\",\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/append", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "append" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"expires_at\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-5c061d2a-c25a-42ef-b385-457315b9e641" }, { "id": "a2d260e4-ab3c-41e3-a7bd-39d49b9f6dc1", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"media\": \"\",\n \"segment_index\": \"\",\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/append", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "append" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-a2d260e4-ab3c-41e3-a7bd-39d49b9f6dc1" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-0d41a7eb-69f3-4f5f-b996-25b5f22e0009" } ], "id": "634428b1-eb2e-461b-afc6-1bd0f6e753e5", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-634428b1-eb2e-461b-afc6-1bd0f6e753e5" }, { "name": "finalize", "item": [ { "name": "Finalize Chat Media Upload", "id": "157f4d98-51b0-41ed-b0c3-47e57ee36c69", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\",\n \"message_id\": \"\",\n \"num_parts\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/finalize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "finalize" ], "variable": [ { "id": "bc23c2d6-79dc-4846-b2d0-796a5e075d58", "key": "id", "value": "", "description": "(Required) The session/resume id from initialize." } ] }, "description": "Finalizes an XChat media upload session." }, "response": [ { "id": "491f3f25-0452-4fd2-8c70-8cbde828805b", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\",\n \"message_id\": \"\",\n \"num_parts\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/finalize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "finalize" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"success\": \"\"\n }\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-491f3f25-0452-4fd2-8c70-8cbde828805b" }, { "id": "ce866a8e-39bc-4b01-ae8b-d60783d2082a", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"conversation_id\": \"\",\n \"media_hash_key\": \"\",\n \"message_id\": \"\",\n \"num_parts\": \"\",\n \"ttl_msec\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/chat/media/upload/:id/finalize", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", "upload", ":id", "finalize" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-ce866a8e-39bc-4b01-ae8b-d60783d2082a" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-157f4d98-51b0-41ed-b0c3-47e57ee36c69" } ], "id": "f9dd9f06-6861-4234-a5dd-3725517c5196", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f9dd9f06-6861-4234-a5dd-3725517c5196" } ], "id": "3273ca18-c299-4b98-bc76-0bb778a77fc7", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-3273ca18-c299-4b98-bc76-0bb778a77fc7" } ], "id": "eb813a69-fd26-47a6-9720-b2598afd6cec", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-eb813a69-fd26-47a6-9720-b2598afd6cec" }, { "name": "{id}", "item": [ { "name": "{media_hash_key}", "item": [ { "name": "Download Chat Media", "id": "f218f2f1-e684-473b-8568-6067deb0bf86", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/octet-stream" } ], "url": { "raw": "{{baseUrl}}/2/chat/media/:id/:media_hash_key", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", ":id", ":media_hash_key" ], "variable": [ { "id": "950ab1a7-00c8-4d6f-931c-7afb50e74a5b", "key": "id", "value": "2173054105468-1806707161065485661", "description": "(Required) The recipient's user ID for a 1:1 conversation, the hyphen-separated 1:1 conversation ID (e.g. '123-456'), or a group conversation ID (prefixed with 'g')." }, { "id": "e437f895-b0dd-4f2a-b45e-e85b8f576d61", "key": "media_hash_key", "value": "3JqDiIs84SW6t33u92lhqmnoSYlyiYAAJuftu", "description": "(Required) The media hash key returned from the upload initialize step." } ] }, "description": "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." }, "response": [ { "id": "391b5a87-664e-42b4-a2b1-6560bbe97489", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/octet-stream" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/media/:id/:media_hash_key", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", ":id", ":media_hash_key" ], "variable": [ { "key": "id" }, { "key": "media_hash_key" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [ { "key": "Content-Type", "value": "application/octet-stream" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-391b5a87-664e-42b4-a2b1-6560bbe97489" }, { "id": "b0d30c6f-4083-4c30-a687-dbb2716be665", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/chat/media/:id/:media_hash_key", "host": [ "{{baseUrl}}" ], "path": [ "2", "chat", "media", ":id", ":media_hash_key" ], "variable": [ { "key": "id" }, { "key": "media_hash_key" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-b0d30c6f-4083-4c30-a687-dbb2716be665" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f218f2f1-e684-473b-8568-6067deb0bf86" } ], "id": "21205f6e-e7f1-49d9-bf3f-a84fd018d0c9", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-21205f6e-e7f1-49d9-bf3f-a84fd018d0c9" } ], "id": "d788aadc-dbd4-4851-843c-2aaf84d562bf", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-d788aadc-dbd4-4851-843c-2aaf84d562bf" } ], "id": "e4a4a585-fa7a-4f35-b108-8bb0ecacf784", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-e4a4a585-fa7a-4f35-b108-8bb0ecacf784" } ], "id": "8c80f53b-e7b3-40cb-89d3-4e734a265a99", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8c80f53b-e7b3-40cb-89d3-4e734a265a99" }, { "name": "users", "item": [ { "name": "public_keys", "item": [ { "name": "Get public keys for multiple users", "id": "f6da791d-671c-4085-be40-e569a70f3b5b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/users/public_keys?ids=7203024517&public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", "public_keys" ], "query": [ { "description": "(Required) A list of User IDs, comma-separated. You can specify up to 100 IDs.", "key": "ids", "value": "7203024517" }, { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ] }, "description": "Returns the public keys and Juicebox configuration for the specified users." }, "response": [ { "id": "62ba22fe-12af-4315-bcc4-7fbe8eba2fb1", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/users/public_keys?ids=7203024517&public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", "public_keys" ], "query": [ { "description": "(Required) A list of User IDs, comma-separated. You can specify up to 100 IDs.", "key": "ids", "value": "7203024517" }, { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"identity_public_key_signature\": \"\",\n \"juicebox_config\": {\n \"key_store_token_map_json\": \"\",\n \"max_guess_count\": \"\",\n \"realm_state_string\": \"\",\n \"recover_threshold\": \"\",\n \"register_threshold\": \"\",\n \"token_map\": [\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n }\n ]\n },\n \"public_key\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-62ba22fe-12af-4315-bcc4-7fbe8eba2fb1" }, { "id": "f47ed7db-6c68-4ba5-a9f6-2aa8594eccdf", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/users/public_keys?ids=7203024517&public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", "public_keys" ], "query": [ { "description": "(Required) A list of User IDs, comma-separated. You can specify up to 100 IDs.", "key": "ids", "value": "7203024517" }, { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f47ed7db-6c68-4ba5-a9f6-2aa8594eccdf" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f6da791d-671c-4085-be40-e569a70f3b5b" } ], "id": "05ba8e59-1437-40fd-9e9c-0aff24de50c8", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-05ba8e59-1437-40fd-9e9c-0aff24de50c8" }, { "name": "{id}", "item": [ { "name": "public_keys", "item": [ { "name": "Get user public keys", "id": "31d0cbef-2a54-4cc6-bba9-ed350f896ce8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys?public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "query": [ { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ], "variable": [ { "id": "6ff0453d-9625-4bf7-afd3-03b66493461e", "key": "id", "value": "128852775003525365", "description": "(Required) The ID of the User to lookup." } ] }, "description": "Returns the public keys and Juicebox configuration for the specified user." }, "response": [ { "id": "f0c813da-261d-44d5-8f85-dbc78d5cfa95", "name": "The request has succeeded.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys?public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "query": [ { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"identity_public_key_signature\": \"\",\n \"juicebox_config\": {\n \"key_store_token_map_json\": \"\",\n \"max_guess_count\": \"\",\n \"realm_state_string\": \"\",\n \"recover_threshold\": \"\",\n \"register_threshold\": \"\",\n \"token_map\": [\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n }\n ]\n },\n \"public_key\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n }\n ],\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-f0c813da-261d-44d5-8f85-dbc78d5cfa95" }, { "id": "cb71cd73-0e55-47f1-97a5-41bb83c0a090", "name": "The request has failed.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys?public_key.fields=identity_public_key_signature", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "query": [ { "description": "A comma separated list of PublicKey fields to display.", "key": "public_key.fields", "value": "identity_public_key_signature" } ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-cb71cd73-0e55-47f1-97a5-41bb83c0a090" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-31d0cbef-2a54-4cc6-bba9-ed350f896ce8" }, { "name": "Add public key", "id": "b5364098-5cd0-4856-8d86-d24c6f255708", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "block.read bookmark.read bookmark.write dm.read dm.write follows.read follows.write like.read like.write list.read list.write media.write mute.read mute.write offline.access space.read timeline.read tweet.moderate.write tweet.read tweet.write users.read", "type": "string" }, { "key": "accessTokenUrl", "value": "https://api.x.com/2/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://api.x.com/2/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"public_key\": {\n \"identity_public_key_signature\": \"\",\n \"public_key\": \"\",\n \"public_key_fingerprint\": \"\",\n \"registration_method\": \"\",\n \"signing_public_key\": \"\",\n \"signing_public_key_signature\": \"\"\n },\n \"version\": \"\",\n \"generate_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "variable": [ { "id": "e4ac5df5-7bf3-4b32-bf0d-6deb67d54e90", "key": "id", "value": "128852775003525365", "description": "(Required) The ID of the requesting user." } ] }, "description": "Registers a user's public key for X Chat encryption." }, "response": [ { "id": "8856c581-7307-45e9-92c3-2a66015b0733", "name": "The request has succeeded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"public_key\": {\n \"identity_public_key_signature\": \"\",\n \"public_key\": \"\",\n \"public_key_fingerprint\": \"\",\n \"registration_method\": \"\",\n \"signing_public_key\": \"\",\n \"signing_public_key_signature\": \"\"\n },\n \"version\": \"\",\n \"generate_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": {\n \"identity_public_key_signature\": \"\",\n \"juicebox_config\": {\n \"key_store_token_map_json\": \"\",\n \"max_guess_count\": \"\",\n \"realm_state_string\": \"\",\n \"recover_threshold\": \"\",\n \"register_threshold\": \"\",\n \"token_map\": [\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n },\n {\n \"key\": \"\",\n \"value\": {\n \"address\": \"\",\n \"public_key\": \"\",\n \"token\": \"\"\n }\n }\n ]\n },\n \"public_key\": \"\",\n \"public_key_version\": \"\",\n \"signing_public_key\": \"\"\n },\n \"errors\": [\n {\n \"type\": \"\",\n \"title\": \"\",\n \"detail\": \"\",\n \"status\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-8856c581-7307-45e9-92c3-2a66015b0733" }, { "id": "551e2e97-4bbc-4886-96ce-de4e0c906588", "name": "The request has failed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"public_key\": {\n \"identity_public_key_signature\": \"\",\n \"public_key\": \"\",\n \"public_key_fingerprint\": \"\",\n \"registration_method\": \"\",\n \"signing_public_key\": \"\",\n \"signing_public_key_signature\": \"\"\n },\n \"version\": \"\",\n \"generate_version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/2/users/:id/public_keys", "host": [ "{{baseUrl}}" ], "path": [ "2", "users", ":id", "public_keys" ], "variable": [ { "key": "id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-551e2e97-4bbc-4886-96ce-de4e0c906588" } ], "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-b5364098-5cd0-4856-8d86-d24c6f255708" } ], "id": "ba915e0c-01c4-4196-98d5-5ae8415919cf", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-ba915e0c-01c4-4196-98d5-5ae8415919cf" } ], "id": "c5014d42-6721-4404-b012-42fd76211e7a", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-c5014d42-6721-4404-b012-42fd76211e7a" } ], "id": "c08cf2c9-b297-4c1c-afd6-af1bc2b7169c", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-c08cf2c9-b297-4c1c-afd6-af1bc2b7169c" } ], "id": "63bca612-7a41-4e6a-8016-01117560b20b", "createdAt": "2026-07-28T03:21:18.000Z", "updatedAt": "2026-07-28T03:21:18.000Z", "uid": "35240-63bca612-7a41-4e6a-8016-01117560b20b" } ], "variable": [ { "key": "baseUrl", "value": "https://api.x.com" } ] }