Apps API · Conversation Uploads
Conversation Uploads: 2 endpoints
POST /api/v1/conversations/uploads/finalize
Finalize conversation upload
Scope: messages:message:send · Called with: appToken · operationId: finalize-conversation-upload
Required app scope: messages:message:send.
Finalizes a media upload. Response wrapped in standard envelope.
Request body
application/json · FinalizeCommUploadRequestBody
| Field | Type | Required | Description |
|---|---|---|---|
upload_token |
string | yes | Upload token |
Responses
200OK —application/json·DataResponseFinalizeUploadResultBodydefaultError —application/problem+json·D8Error
POST /api/v1/conversations/{conversation_id}/uploads/prepare
Prepare conversation upload
Scope: messages:message:send · Called with: appToken · operationId: prepare-conversation-upload
Required app scope: messages:message:send.
Prepares a media upload. expires_at is returned as a string. Response wrapped in standard envelope.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
conversation_id |
path | string (uuid) | yes | Conversation UUID |
Request body
application/json · PrepareCommUploadRequestBody
| Field | Type | Required | Description |
|---|---|---|---|
content_type |
string | yes | Content type |
filename |
string | yes | File name |
size_bytes |
integer (int64) | yes | File size in bytes |
Responses
200OK —application/json·DataResponsePrepareUploadResultBodydefaultError —application/problem+json·D8Error
