Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Orchestra (BYOK) — connector documentation

  • MCP endpoint: https://byok-orchestra.connectorbay.com/mcp
  • REST API: POST https://byok-orchestra.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-orchestra.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Orchestra Orchestra workspace API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-orchestra.connectorbay.com/health · Tool schemas: https://byok-orchestra.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-orchestra · agent@connectorbay.com

What Orchestra (BYOK) is for

Orchestra (BYOK) lets an AI assistant read your own Orchestra data through the Orchestra API with a key you supply (Orchestra workspace API key). Read-only: 11 tools (list_pipeline_runs, get_pipeline_run_status, list_pipeline_run_tasks, list_task_runs, list_assets, get_asset, list_incidents, get_incident, list_monitors, list_environments, list_operations). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to app.getorchestra.io. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Orchestra. Orchestra and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which Orchestra pipeline runs failed in the last day?"
  • "What is the status of Orchestra pipeline run 7c1e0a52?"
  • "Which tasks of Orchestra pipeline run 7c1e0a52 failed?"
  • "Which Fivetran tasks failed recently in Orchestra?"
  • "Which Orchestra assets are unhealthy?"
  • "Show Orchestra asset a-1"

What it does

  • list_pipeline_runs: List pipeline runs (newest first by default) with status, environment, timing and branch; filter by status, pipeline ids, environments or time window.
  • get_pipeline_run_status: Get the pipeline name and current status of one pipeline run by id.
  • list_pipeline_run_tasks: List the task runs of one pipeline run (default 10 per page, up to 50) with integration, status and attempt number.
  • list_task_runs: List task runs across the workspace with integration, status and timing; filter by status, integration, pipelines or time window.
  • list_assets: List data assets (tables, dashboards, datasets) Orchestra tracks, with integration, health status, row count and last successful run.
  • get_asset: Get one asset by Orchestra id or external id with health, size, owner and freshness fields.
  • list_incidents: List incidents (most severe first) with status, severity, assignee and monitor; filter by status, severity or name.
  • get_incident: Get one incident with its status, severity, merge relations, event count and related resources.
  • list_monitors: List incident monitors in evaluation order with name, enabled flag, match rules and the action they take.
  • list_environments: List workspace environments (name, default flag, allowed branches); variable values are not returned.
  • list_operations: List task operations (queries, ingestions, tests) with status, type, duration, rows affected and cost; filter by status, type or integration.

BYOK key

You bring your own Orchestra Orchestra workspace API key (https://app.getorchestra.io/settings). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to app.getorchestra.io over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Orchestra API (app.getorchestra.io) with a BYOK key; documentation: https://docs.getorchestra.io/. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Orchestra. Orchestra and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Orchestra account.

Built for: Worldwide. Languages: English.