{"openapi":"3.1.0","info":{"title":"Signadot (BYOK) API","version":"0.1.0","description":"Signadot (BYOK) lets an AI assistant read your own Signadot data through the Signadot API with a key you supply (Signadot API key). Read-only: 9 tools (list_organizations, list_sandboxes, get_sandbox, list_route_groups, get_route_group, list_clusters, get_cluster, list_resource_plugins, get_resource_plugin). The BYOK key travels with each request, is used for that one call only and is never...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-signadot.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-signadot/docs"},"termsOfService":"https://connectorbay.com/byok-signadot/terms"},"servers":[{"url":"https://byok-signadot.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-signadot/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_organizations":{"post":{"operationId":"list_organizations","summary":"List the Signadot organizations the API key can access, with the organization name needed by the other tools. Use for \"W","description":"List the Signadot organizations the API key can access, with the organization name needed by the other tools. Use for \"Which Signadot organizations can my key access\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_organizationsArguments","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_sandboxes":{"post":{"operationId":"list_sandboxes","summary":"List the sandboxes in a Signadot organization with routing key, cluster, description, preview endpoints and status. Use ","description":"List the sandboxes in a Signadot organization with routing key, cluster, description, preview endpoints and status. Use for \"Which Signadot sandboxes are running in my org\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"}},"required":["org_name"],"title":"list_sandboxesArguments","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_sandbox":{"post":{"operationId":"get_sandbox","summary":"Get one sandbox: routing key, cluster, description, preview endpoints and readiness status. Use for \"Show the Signadot s","description":"Get one sandbox: routing key, cluster, description, preview endpoints and readiness status. Use for \"Show the Signadot sandbox checkout-pr-482\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"},"sandbox_name":{"description":"Sandbox name.","maxLength":120,"title":"Sandbox Name","type":"string"}},"required":["org_name","sandbox_name"],"title":"get_sandboxArguments","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_route_groups":{"post":{"operationId":"list_route_groups","summary":"List the route groups in a Signadot organization with routing key, cluster, endpoints and matched sandboxes. Use for \"Wh","description":"List the route groups in a Signadot organization with routing key, cluster, endpoints and matched sandboxes. Use for \"Which Signadot route groups do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"}},"required":["org_name"],"title":"list_route_groupsArguments","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_route_group":{"post":{"operationId":"get_route_group","summary":"Get one route group: routing key, cluster, endpoints, and status with matched sandboxes. Use for \"Show the Signadot rout","description":"Get one route group: routing key, cluster, endpoints, and status with matched sandboxes. Use for \"Show the Signadot route group payments-rg\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"},"routegroup_name":{"description":"Route group name.","maxLength":120,"title":"Routegroup Name","type":"string"}},"required":["org_name","routegroup_name"],"title":"get_route_groupArguments","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_clusters":{"post":{"operationId":"list_clusters","summary":"List the Kubernetes clusters connected to a Signadot organization with creation time and operator version. Use for \"Whic","description":"List the Kubernetes clusters connected to a Signadot organization with creation time and operator version. Use for \"Which clusters are connected to my Signadot org\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"}},"required":["org_name"],"title":"list_clustersArguments","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_cluster":{"post":{"operationId":"get_cluster","summary":"Get one connected cluster: creation time and Signadot operator version (cluster tokens are not exposed). Use for \"Show t","description":"Get one connected cluster: creation time and Signadot operator version (cluster tokens are not exposed). Use for \"Show the Signadot cluster staging-cluster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"},"cluster_name":{"description":"Connected cluster name.","maxLength":120,"title":"Cluster Name","type":"string"}},"required":["org_name","cluster_name"],"title":"get_clusterArguments","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_resource_plugins":{"post":{"operationId":"list_resource_plugins","summary":"List the resource plugins registered in a Signadot organization with creation and update time and status. Use for \"Which","description":"List the resource plugins registered in a Signadot organization with creation and update time and status. Use for \"Which Signadot resource plugins are registered\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"}},"required":["org_name"],"title":"list_resource_pluginsArguments","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_resource_plugin":{"post":{"operationId":"get_resource_plugin","summary":"Get one resource plugin: creation and update time and status. Use for \"Show the Signadot resource plugin postgres-db\".","description":"Get one resource plugin: creation and update time and status. Use for \"Show the Signadot resource plugin postgres-db\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_name":{"description":"Signadot organization name (shown in the dashboard and returned by list_organizations).","maxLength":80,"title":"Org Name","type":"string"},"plugin_name":{"description":"Resource plugin name.","maxLength":120,"title":"Plugin Name","type":"string"}},"required":["org_name","plugin_name"],"title":"get_resource_pluginArguments","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}}}}