chat.prepare_uploadPrepare one attachment upload for the selected conversation or eligible client contact. The returned HTTP contract accepts multipart file with Authorization: Bearer transfer_token. A completed upload returns an attachment ID; preparation alone neither uploads nor sends.
- Operation
- write
- OAuth scopes
- mcp
Availability depends on your assigned tools. Scopes do not grant record access. Read the tool description and current resource before changing it; follow the required revision and idempotency fields below.
Client portal inputs
| Name and description | Required |
|---|---|
contact_idFor a client first message, use a contact ID from chat.contacts instead of conversation_id. | No |
conversation_idConversation slug returned in the id field by chat.list. Copy it exactly; do not use the group name or a database ID. | No |
filenameSee the input schema for constraints. | Yes |
idempotency_keySee the input schema for constraints. | Yes |
organization_slugSee the input schema for constraints. | Yes |
provider_slugSee the input schema for constraints. | Yes |
sha256See the input schema for constraints. | Yes |
size_bytesSee the input schema for constraints. | Yes |
View exact input schema
Provider portal inputs
| Name and description | Required |
|---|---|
contact_idFor a client first message, use a contact ID from chat.contacts instead of conversation_id. | No |
conversation_idConversation slug returned in the id field by chat.list. Copy it exactly; do not use the group name or a database ID. | No |
filenameSee the input schema for constraints. | Yes |
idempotency_keySee the input schema for constraints. | Yes |
provider_slugCopy the provider slug from providers.list or your client workspace. | Yes |
sha256See the input schema for constraints. | Yes |
size_bytesSee the input schema for constraints. | Yes |
View exact input schema
Result
Check the structured result for success or an error before continuing. Read the affected record to confirm your change.
View exact output schema
For this workflow’s steps and prerequisites, read the Chat and messages guide.
