Create upload

Reserve an upload; PUT raw file bytes to the returned URL

POST https://api.el.ai/v1/uploads

Requires full key access. No request body is needed. Upload URL expires in six hours. Call POST /jobs with upload_id after upload completes.

Authorization

Authorization header · string Required

Bearer el_live_…, a workspace API key. This endpoint needs a key with full access. About keys

Response · 201

application/json

Success.

id string · uuid
object string

One of

upload
upload_url string · uri

Presigned URL for uploading raw file bytes with PUT. No Authorization or storage-specific headers are needed.
method string

One of

PUT
max_size_bytes integer

One of

5242880000
expires_at string · date-time

Headers

request-id string

Support request identifier.
cache-control string

One of

no-store

Errors

Errors share one shape: an error object with a stable code and a human-readable message. See Errors and retries.

400	Invalid request
401	Missing, invalid or revoked API key
402	Insufficient funds or budget
403	Key or workspace does not allow this operation
404	Resource not found in this workspace
409	Conflict
413	JSON body exceeds 64 KiB
415	Unsupported content type
422	Media or order cannot be processed
429	Shared read limit per API key or write limit per workspace exceeded
500	Internal error
503	temporarily_unavailable: request limit enforcement is unavailable, or job submission is busy. Retry after 5 seconds.

curl -X POST https://api.el.ai/v1/uploads \
  -H "Authorization: Bearer $ECHO_API_KEY"

import os
import requests

response = requests.post(
    "https://api.el.ai/v1/uploads",
    headers={
        "Authorization": f"Bearer {os.environ['ECHO_API_KEY']}",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.el.ai/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ECHO_API_KEY}`,
  },
});
const data = await response.json();
console.log(data);

Response

201

{
  "id": "cec18557-248a-4916-938a-4cb386bedcb9",
  "object": "upload",
  "upload_url": "https://storage.example.com/raw-uploads/45cfe506.mp4?sv=…",
  "method": "PUT",
  "max_size_bytes": 5242880000,
  "expires_at": "2026-09-25T20:33:37Z"
}

Error

{
  "error": {
    "code": "invalid_request",
    "message": "Send exactly one of media_url or upload_id.",
    "param": "media_url"
  }
}