{"openapi":"3.1.0","info":{"title":"Bitmovin Encoding (BYOK) API","version":"0.1.0","description":"Bitmovin Encoding (BYOK) lets an AI assistant read your own Bitmovin Encoding data through the Bitmovin Encoding API with a key you supply (Bitmovin API key). Read-only: 10 tools (list_encodings, get_encoding, get_encoding_status, list_encoding_streams, list_encoding_muxings, list_inputs, list_outputs, list_manifests, list_hls_manifests, list_dash_manifests). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-bitmovin.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-bitmovin/docs"},"termsOfService":"https://connectorbay.com/byok-bitmovin/terms"},"servers":[{"url":"https://byok-bitmovin.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-bitmovin/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_encodings":{"post":{"operationId":"list_encodings","summary":"List video encodings with their details, filtered by status, type, name or creation time. Bitmovin keeps encoding histor","description":"List video encodings with their details, filtered by status, type, name or creation time. Bitmovin keeps encoding history for 90 days. Use for \"Which Bitmovin encodings are running right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"status":{"anyOf":[{"enum":["CREATED","QUEUED","RUNNING","FINISHED","ERROR","CANCELED","TRANSFER_ERROR"],"type":"string"},{"type":"null"}],"default":null,"description":"Only encodings in this status: CREATED, QUEUED, RUNNING, FINISHED, ERROR, CANCELED or TRANSFER_ERROR.","title":"Status"},"type":{"anyOf":[{"enum":["VOD","LIVE","NONE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only encodings of this type: VOD, LIVE or NONE.","title":"Type"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only encodings with exactly this name.","title":"Name"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"},"created_after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only encodings created after this ISO 8601 time, for example 2026-01-01T00:00:00Z.","title":"Created After"},"created_before":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only encodings created before this ISO 8601 time.","title":"Created Before"},"include_total_count":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to also return the total number of matches.","title":"Include Total Count"}},"title":"list_encodingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_encoding":{"post":{"operationId":"get_encoding","summary":"Get one encoding: name, progress, encoder version, queued, started and finished times, labels. Use for \"Show the details","description":"Get one encoding: name, progress, encoder version, queued, started and finished times, labels. Use for \"Show the details of Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"encoding_id":{"description":"Id of the encoding (from list_encodings).","maxLength":200,"title":"Encoding Id","type":"string"}},"required":["encoding_id"],"title":"get_encodingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_encoding_status":{"post":{"operationId":"get_encoding_status","summary":"Get the live progress of an encoding: percent done, estimated time left, sub-task states, messages and any error. Use fo","description":"Get the live progress of an encoding: percent done, estimated time left, sub-task states, messages and any error. Use for \"How far along is Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"encoding_id":{"description":"Id of the encoding (from list_encodings).","maxLength":200,"title":"Encoding Id","type":"string"}},"required":["encoding_id"],"title":"get_encoding_statusArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_encoding_streams":{"post":{"operationId":"list_encoding_streams","summary":"List the streams of an encoding (each maps an input to a codec configuration). Use for \"What streams does Bitmovin encod","description":"List the streams of an encoding (each maps an input to a codec configuration). Use for \"What streams does Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"encoding_id":{"description":"Id of the encoding (from list_encodings).","maxLength":200,"title":"Encoding Id","type":"string"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"}},"required":["encoding_id"],"title":"list_encoding_streamsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_encoding_muxings":{"post":{"operationId":"list_encoding_muxings","summary":"List all muxings (output containers such as fMP4, TS or MP4) of an encoding. Use for \"Which muxings were produced by Bit","description":"List all muxings (output containers such as fMP4, TS or MP4) of an encoding. Use for \"Which muxings were produced by Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"encoding_id":{"description":"Id of the encoding (from list_encodings).","maxLength":200,"title":"Encoding Id","type":"string"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"stream_mode":{"anyOf":[{"enum":["STANDARD","PER_TITLE_TEMPLATE","PER_TITLE_TEMPLATE_FIXED_RESOLUTION","PER_TITLE_TEMPLATE_FIXED_RESOLUTION_AND_BITRATE","PER_TITLE_RESULT"],"type":"string"},{"type":"null"}],"default":null,"description":"Only muxings with this stream mode.","title":"Stream Mode"}},"required":["encoding_id"],"title":"list_encoding_muxingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_inputs":{"post":{"operationId":"list_inputs","summary":"List the configured inputs (storage locations and live ingest points that encodings read from), optionally by name or ty","description":"List the configured inputs (storage locations and live ingest points that encodings read from), optionally by name or type. Use for \"Which input sources are set up in my Bitmovin account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only inputs whose name matches.","title":"Name"},"type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only inputs of this type, for example S3 or GCS.","title":"Type"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"}},"title":"list_inputsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_outputs":{"post":{"operationId":"list_outputs","summary":"List the configured outputs (storage locations encodings write to), optionally by name or type. Use for \"Which output st","description":"List the configured outputs (storage locations encodings write to), optionally by name or type. Use for \"Which output storage targets does my Bitmovin account have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only outputs whose name matches.","title":"Name"},"type":{"anyOf":[{"enum":["AKAMAI_NETSTORAGE","AZURE","GENERIC_S3","GCS","FTP","LOCAL","S3","S3_ROLE_BASED","SFTP","AKAMAI_MSL","LIVE_MEDIA_INGEST","GCS_SERVICE_ACCOUNT","CDN"],"type":"string"},{"type":"null"}],"default":null,"description":"Only outputs of this type.","title":"Type"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"}},"title":"list_outputsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_manifests":{"post":{"operationId":"list_manifests","summary":"List all manifests (HLS, DASH and Smooth Streaming) with their type, name and status. Use for \"List my Bitmovin manifest","description":"List all manifests (HLS, DASH and Smooth Streaming) with their type, name and status. Use for \"List my Bitmovin manifests\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"}},"title":"list_manifestsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_hls_manifests":{"post":{"operationId":"list_hls_manifests","summary":"List HLS manifests, optionally only those that belong to one encoding. Use for \"Which HLS manifests belong to Bitmovin e","description":"List HLS manifests, optionally only those that belong to one encoding. Use for \"Which HLS manifests belong to Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"encoding_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only manifests of this encoding.","title":"Encoding Id"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"}},"title":"list_hls_manifestsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_dash_manifests":{"post":{"operationId":"list_dash_manifests","summary":"List DASH manifests, optionally only those that belong to one encoding. Use for \"Which DASH manifests belong to Bitmovin","description":"List DASH manifests, optionally only those that belong to one encoding. Use for \"Which DASH manifests belong to Bitmovin encoding d8b5a1c0-3f4e-4a1b-9c2d-0e6f7a8b9c10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first item to return, starting at 0.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Maximum items to return (1 to 100).","title":"Limit"},"encoding_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only manifests of this encoding.","title":"Encoding Id"},"sort":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Sort expression such as createdAt:desc.","title":"Sort"}},"title":"list_dash_manifestsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}