API endpointsMediaGet a media object's processing status and derived variants GET

Get a media object's processing status and derived variants

GET
/v1/media/{mediaId}

Get a media object's processing status and derived variants.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

mediaId*string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/media/string"
{  "mediaId": "string",  "status": "string",  "origin": "string",  "kind": "string",  "contentType": "string",  "sizeBytes": 0,  "sourceUrl": "string",  "error": {    "property1": null,    "property2": null  },  "statusUrl": "string",  "previewUrl": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": {    "code": "validation_error",    "message": "string",    "meta": {      "property1": null,      "property2": null    }  }}

Create a media object POST

Create a media object. Give an HTTPS `sourceUrl` for Koil to fetch, or omit it to get a pre-signed upload URL in the response. Images may be up to 50 MB and 100 megapixels, videos up to 1 GB. Reference the returned `mediaId` from publish requests within 24 hours of creating it. Requires an `Idempotency-Key`.

Delete a media object and its derived variants DELETE

Delete a media object and its derived variants. Publishes already running keep their own staged copy.