Skip to main content
POST
/
v1
/
jobs
Create a job
curl --request POST \
  --url https://api.mediapi.dev/v1/jobs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": "https://example.com/video.mp4",
  "operations": [
    {
      "type": "transcode",
      "params": {
        "format": "mp4",
        "codec": "h264"
      }
    }
  ],
  "webhook_url": "<string>",
  "file_size": 123
}
'
{
  "id": "<string>",
  "status": "pending"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
input
required

Single input URL

Example:

"https://example.com/video.mp4"

​
operations
object[]
required
Example:
[
  {
    "type": "transcode",
    "params": { "format": "mp4", "codec": "h264" }
  }
]
​
webhook_url
string

URL to receive job completion notification

​
file_size
integer

File size hint in bytes (for plan limit validation)

Response

Job accepted

​
id
string
​
status
string
Example:

"pending"