Skip to main content

Documentation Index

Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Files API

Generic file storage for everything that needs an attachment — MMS images, WhatsApp media, agent-side documents, message templates, campaign assets. Files live in Cloud Storage; URLs are signed and time-limited. Base path: /v1/files Authentication: API key (X-API-Key) or session JWT. Upload limits: 25 MB per file (multipart form data).
MethodPathPurpose
POST/v1/files/uploadUpload a file (multipart)
GET/v1/files/List files
GET/v1/files/{id}Get file metadata + signed URL
DELETE/v1/files/{id}Delete a file

​
Example — upload an image for an MMS

curl -X POST https://orbit-api.devotel.io/api/v1/files/upload \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -F "file=@./promo.jpg" \
  -F "purpose=mms_attachment"
The response includes the file ID and a signed URL; pass the file ID to POST /v1/messages/sms (with media_url set to the signed URL) to send an MMS.

​
See also