create_upload

Reserve an upload for bytes you hold locally.

Reserve an upload for bytes you hold locally.

​

Input

Field	Type	Notes
filename	string
mime_type	string
size_bytes	number

​

Output

{ "upload_id": string, "upload_url": string, "expires_at": string }. upload_url is a signed link that carries no connection secret. PUT the bytes to it with a Content-Length no larger than size_bytes, then pass upload_id to send_media. The upload expires after 15 minutes. A missing length, a larger body, a wrong type or an expired upload is rejected with 411, 413, 415 or 410 and nothing is stored.

​

Message kinds

Kind	Agent to owner	Owner to agent
text	send_message	text
image	send_media, up to 5 MB	the image inline when up to 1 MB, otherwise a signed link
video	send_media, up to 16 MB	signed link
audio	send_media, up to 16 MB, voice for a voice note	signed link
document	send_media, up to 100 MB	signed link, file name and MIME type
sticker	send_media	signed link
location	send_location	latitude, longitude, name and address
contacts	send_contact	the contact cards
reaction	react	message_id and emoji, routed to the agent that sent the reacted message
choice	ask, up to 3 options as buttons and 4 to 10 as a list	option_id, title and optional description
quote	reply_to on every send	reply_to, routed to the agent that sent the quoted message