{"openapi":"3.1.0","info":{"title":"Bitrise Pipelines (BYOK) API","version":"0.1.0","description":"Bitrise Pipelines (BYOK) lets an AI assistant read your own Bitrise Pipelines data through the Bitrise Pipelines API with a key you supply (personal access token). Read-only: 5 tools (list_pipelines, list_app_pipelines, get_pipeline, list_archived_builds, list_build_requests). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-bitrise-pipelines.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-bitrise-pipelines/docs"},"termsOfService":"https://connectorbay.com/byok-bitrise-pipelines/terms"},"servers":[{"url":"https://byok-bitrise-pipelines.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-bitrise-pipelines/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_pipelines":{"post":{"operationId":"list_pipelines","summary":"List pipelines and standalone builds across all apps of an account or organization, newest first, with status code, bran","description":"List pipelines and standalone builds across all apps of an account or organization, newest first, with status code, branch, workflow, credit cost and times. Triggering user and commit message are left out. Use for \"Which Bitrise pipelines are running right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner_slug":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Only apps owned by this account or organization slug.","title":"Owner Slug"},"status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only pipelines or standalone builds with this status, for example on_hold, running, succeeded or failed.","title":"Status"},"next":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the 'paging.next' value of the previous answer (an RFC 3339 time). Leave out for the first page.","title":"Next"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items per page (default 10).","title":"Limit"}},"title":"list_pipelinesArguments","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_app_pipelines":{"post":{"operationId":"list_app_pipelines","summary":"List one app's pipelines and standalone builds with status code, branch, workflow, credit cost and times; filter by bran","description":"List one app's pipelines and standalone builds with status code, branch, workflow, credit cost and times; filter by branch, status, workflow, pipeline name, trigger event or date. Use for \"Show the last Bitrise pipeline runs of my app on the main branch\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"app_slug":{"description":"Bitrise app slug (the id in the app's URL), as returned by list_apps in the Bitrise connector.","maxLength":80,"title":"App Slug","type":"string"},"branch":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only builds of this branch.","title":"Branch"},"status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only pipelines or standalone builds with this status, for example on_hold, running, succeeded or failed.","title":"Status"},"workflow":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this workflow name.","title":"Workflow"},"pipeline":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this pipeline name.","title":"Pipeline"},"trigger_event_type":{"anyOf":[{"enum":["push","pull-request","tag"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this trigger event: push, pull-request or tag.","title":"Trigger Event Type"},"after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs after this RFC 3339 time.","title":"After"},"before":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs before this RFC 3339 time.","title":"Before"},"next":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Paging cursor: the 'paging.next' value of the previous answer (an RFC 3339 time). Leave out for the first page.","title":"Next"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items per page (default 10).","title":"Limit"}},"required":["app_slug"],"title":"list_app_pipelinesArguments","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_pipeline":{"post":{"operationId":"get_pipeline","summary":"Get one pipeline of an app: status, abort reason, trigger time, and its stages and workflows with their statuses and cre","description":"Get one pipeline of an app: status, abort reason, trigger time, and its stages and workflows with their statuses and credit cost. Use for \"Which stages and workflows did Bitrise pipeline 9f8e7d6c run and did they pass\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"app_slug":{"description":"Bitrise app slug (the id in the app's URL), as returned by list_apps in the Bitrise connector.","maxLength":80,"title":"App Slug","type":"string"},"pipeline_id":{"description":"Pipeline id, as returned in the 'slug' or id field of the pipeline lists.","maxLength":80,"title":"Pipeline Id","type":"string"}},"required":["app_slug","pipeline_id"],"title":"get_pipelineArguments","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_archived_builds":{"post":{"operationId":"list_archived_builds","summary":"List archived builds of an app (up to 1000) between two Unix times, with status, branch, workflow, credit cost and finis","description":"List archived builds of an app (up to 1000) between two Unix times, with status, branch, workflow, credit cost and finish time. Use for \"Which Bitrise builds of my app were archived in September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"app_slug":{"description":"Bitrise app slug (the id in the app's URL), as returned by list_apps in the Bitrise connector.","maxLength":80,"title":"App Slug","type":"string"},"after":{"description":"Only builds that ran after this Unix time in seconds.","minimum":0,"title":"After","type":"integer"},"before":{"description":"Only builds that ran before this Unix time in seconds.","minimum":0,"title":"Before","type":"integer"},"limit":{"description":"Maximum number of builds (1 to 1000).","maximum":1000,"minimum":1,"title":"Limit","type":"integer"}},"required":["app_slug","after","before","limit"],"title":"list_archived_buildsArguments","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_build_requests":{"post":{"operationId":"list_build_requests","summary":"List the open build requests of an app (builds waiting for approval), with creation time and pull request URL. Use for \"","description":"List the open build requests of an app (builds waiting for approval), with creation time and pull request URL. Use for \"Does my Bitrise app have build requests waiting for approval\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"app_slug":{"description":"Bitrise app slug (the id in the app's URL), as returned by list_apps in the Bitrise connector.","maxLength":80,"title":"App Slug","type":"string"}},"required":["app_slug"],"title":"list_build_requestsArguments","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}}}}