Docs
Esc

Suggested

QuickstartGet started
Webhooks and signaturesMessaging
Create a messagemessages.create · POST /v1/accounts/{AC}/messages
RATE_LIMITED429 · Rate limit exceeded.
message.deliveredMessage resource
Contents

API reference

Media

API reference descriptions are provided in English to preserve the exact published contract.

List media objects and scan/retention state

GET/v1/accounts/{AC}/media

media.listSDK operation getV1AccountsByAcMedia

Required scope: media:read.Paginated

Parameters

  • limitinteger (1–100)query
  • cursorstring (max 2048 chars)query

Upload or fetch media

POST/v1/accounts/{AC}/media

media.createSDK operation postV1AccountsByAcMedia

Upload a file (multipart) or have Toutye fetch one from a URL. Use the returned media SID in a message. Files are scanned before they can be sent.

Required scope: media:write.Idempotency-Key required

Request body

  • urlstring (max 4096 chars)Required
  • declaredMimestring (max 255 chars)
  • filenamestring
  • typeenum

    AUTOIMAGEAUDIOVIDEODOCUMENTSTICKER

Create a template-header resumable upload

POST/v1/accounts/{AC}/media/uploads

media.uploadsSDK operation postV1AccountsByAcMediaUploads

Required scope: media:write.Idempotency-Key required

Request body

  • mediaSidstring (ME… SID)Required

Fetch media metadata

GET/v1/accounts/{AC}/media/{ME}

media.retrieveSDK operation getV1AccountsByAcMediaByMe

Fetch a media object's type, size, scan result and expiry.

Required scope: media:read.

Parameters

  • MEstring (ME… SID)Required

Delete media

DELETE/v1/accounts/{AC}/media/{ME}

media.deleteSDK operation deleteV1AccountsByAcMediaByMe

Required scope: media:write.

Parameters

  • MEstring (ME… SID)Required