Create a media object
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.
Authorization
bearerAuth In: header
Header Parameters
A unique key for this request, scoped to the Organization and operation. Retrying with the same key and payload returns the first result instead of repeating the work; the same key with a different payload is refused with 409 conflict. Keys expire 24 hours after first use, and a request still in flight after 15 minutes releases its key.
\S1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/media" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{}'{ "mediaId": "string", "status": "string", "uploadUrl": "string", "statusUrl": "string"}{ "error": { "code": "validation_error", "message": "string", "meta": { "property1": null, "property2": null } }}