Overview
Posts
Users
Direct Messages
Lists
Spaces
Communities
Community Notes
Trends
Media
X Activity
Stream Connections
Compliance
Append Chat Media Upload
Appends media data to an XChat upload session.
POST
/
2
/
chat
/
media
/
upload
/
{id}
/
append
Append Chat Media Upload
curl --request POST \
--url https://api.x.com/2/chat/media/upload/{id}/append \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"conversation_id": "<string>",
"media": "<string>",
"media_hash_key": "<string>",
"segment_index": 499
}
'{
"data": {
"expires_at": 123
},
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
]
}Documentation Index
Fetch the complete documentation index at: https://docs.x.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
OAuth2UserTokenUserToken
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The session/resume id from initialize.
Body
application/jsonmultipart/form-data
- Option 1
- Option 2
XChat conversation identifier for the upload.
The file to upload.
Media hash key returned from initialize.
An integer value representing the media upload segment.
Required range:
0 <= x <= 999Response
The request has succeeded.
A response from getting a media upload request status.
Show child attributes
Show child attributes
Minimum array length:
1An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
Show child attributes
Show child attributes
⌘I
Append Chat Media Upload
curl --request POST \
--url https://api.x.com/2/chat/media/upload/{id}/append \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"conversation_id": "<string>",
"media": "<string>",
"media_hash_key": "<string>",
"segment_index": 499
}
'{
"data": {
"expires_at": 123
},
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
]
}