Create an upload link

POST/v1/media/uploads

A presigned link to upload a file to send.

Scope messages:writeIdempotency-Key required

Request body

mime_typestringRequired: 1 to 255 characters
size_bytesintegerRequired
file_namestringRequired: 1 to 255 characters

Response

201Success

Response fields

upload_urlstringRequired
media_keystringRequired
expires_atstring, date-timeRequired
kindstringRequired

Errors

400idempotency_key_required
401unauthorized. The key is missing, unknown or revoked
403insufficient_scope. The key lacks the scope above
409idempotency_conflict
422validation_error, media_invalid
503unavailable. media storage is not configured

Every error has the same shape. See Errors.

1curl -X POST https://api.omnio.sawego.com/v1/media/uploads \
2  -H "Authorization: Bearer $OMNIO_API_KEY"
3  -H "Idempotency-Key: $(uuidgen)"
4  -H "Content-Type: application/json"
5  -d '{
6    "mime_type": "application/pdf",
7    "size_bytes": 182044,
8    "file_name": "receipt.pdf"
9  }'

1{
2  "mime_type": "application/pdf",
3  "size_bytes": 182044,
4  "file_name": "receipt.pdf"
5}

1{
2  "upload_url": "https://files.example.com/upload",
3  "media_key": "5f3e2b1c/uploads/2026/10/3c5e7a90.pdf",
4  "expires_at": "2026-10-05T14:02:11Z",
5  "kind": "kind"
6}