Studio
Start an upload or URL import
POST
For an upload, the response carries a pre-signed uploadUrl: PUT the file there, then call complete-upload. For a URL, Ingenee fetches it. Files up to 4.5 GiB.
Note: Processing spends media credits.
Scope: studio:write
apiKeyheader
AuthorizationBearer <ik_live_…>An organisation API key from Settings → Organisation → API keys. Each operation names the one scope it needs — see https://developer.ingenee.ai/docs/authentication.
Idempotency-Key?stringAny unique string. A retry with the same key and the same request gets the first answer back instead of running twice (kept 24 hours).
Length
length <= 255application/json- body
assetId?stringFormat
uuidtitle?stringLength
1 <= length <= 300source*stringValue in
"upload""url""s3""manifest""mrss"sourceRef*stringLength
1 <= length <= 2048contentType?stringLength
length <= 200operations?array<>Default
[]context?catalogId?stringFormat
uuidnewCatalogName?stringLength
1 <= length <= 200libraryType?stringValue in
"movie""episode""series""song"bytes?integerRange
0 <= valueOK
application/json- response
[key: string]?anyExample Request
curl -X POST 'https://dev.app.ingenee.ai/api/v1/studio/jobs' \ -H 'Content-Type: application/json' \ -d '{ "source": "upload", "sourceRef": "string"}'Example Response
{}