{"openapi":"3.1.0","info":{"title":"Humanitec (BYOK) API","version":"0.1.0","description":"Humanitec (BYOK) lets an AI assistant read your own Humanitec data through the Humanitec API with a key you supply (Humanitec API token (static token of a service user or user)). Read-only: 11 tools (list_organizations, get_organization, list_applications, list_environments, list_deployments, list_active_resources, list_pipelines, list_pipeline_runs, list_environment_types,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-humanitec.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-humanitec/docs"},"termsOfService":"https://connectorbay.com/byok-humanitec/terms"},"servers":[{"url":"https://byok-humanitec.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-humanitec/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 Humanitec organizations the token has access to. Use for \"Which Humanitec organizations can I access\".","description":"List the Humanitec organizations the token has access to. Use for \"Which Humanitec organizations can I 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/get_organization":{"post":{"operationId":"get_organization","summary":"Get one organization by ID. Use for \"Show my Humanitec organization\".","description":"Get one organization by ID. Use for \"Show my Humanitec organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"}},"required":["org_id"],"title":"get_organizationArguments","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_applications":{"post":{"operationId":"list_applications","summary":"List applications in the organization with status and their environments. Use for \"Which applications exist in my Humani","description":"List applications in the organization with status and their environments. Use for \"Which applications exist in my Humanitec organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"}},"required":["org_id"],"title":"list_applicationsArguments","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_environments":{"post":{"operationId":"list_environments","summary":"List the environments of an application with type, status and the status and time of the last deployment. Use for \"Which","description":"List the environments of an application with type, status and the status and time of the last deployment. Use for \"Which environments does my Humanitec app have and were their last deploys healthy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"app_id":{"description":"ID of the application, as returned by list_applications.","maxLength":200,"title":"App Id","type":"string"}},"required":["org_id","app_id"],"title":"list_environmentsArguments","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_deployments":{"post":{"operationId":"list_deployments","summary":"List deployments of an environment, newest first, with status, comment, mode and time. Use for \"What were the latest dep","description":"List deployments of an environment, newest first, with status, comment, mode and time. Use for \"What were the latest deployments of my Humanitec development environment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"app_id":{"description":"ID of the application, as returned by list_applications.","maxLength":200,"title":"App Id","type":"string"},"env_id":{"description":"ID of the environment, as returned by list_environments.","maxLength":200,"title":"Env Id","type":"string"}},"required":["org_id","app_id","env_id"],"title":"list_deploymentsArguments","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_active_resources":{"post":{"operationId":"list_active_resources","summary":"List the active resources (databases, DNS, volumes and so on) provisioned in an environment with type, class, status and","description":"List the active resources (databases, DNS, volumes and so on) provisioned in an environment with type, class, status and driver. Use for \"What resources are provisioned in my Humanitec development environment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"app_id":{"description":"ID of the application, as returned by list_applications.","maxLength":200,"title":"App Id","type":"string"},"env_id":{"description":"ID of the environment, as returned by list_environments.","maxLength":200,"title":"Env Id","type":"string"}},"required":["org_id","app_id","env_id"],"title":"list_active_resourcesArguments","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_pipelines":{"post":{"operationId":"list_pipelines","summary":"List delivery pipelines of the organization with application, status, version and trigger types. Use for \"Which Humanite","description":"List delivery pipelines of the organization with application, status, version and trigger types. Use for \"Which Humanitec pipelines exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of items to return (1 to 100, default 50).","title":"Per Page"},"trigger":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only pipelines with this trigger type.","title":"Trigger"}},"required":["org_id"],"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_pipeline_runs":{"post":{"operationId":"list_pipeline_runs","summary":"List pipeline runs newest first with status, trigger, environments and start and completion time. Use for \"Which Humanit","description":"List pipeline runs newest first with status, trigger, environments and start and completion time. Use for \"Which Humanitec pipeline runs failed recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of items to return (1 to 100, default 50).","title":"Per Page"},"env":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs for this environment ID.","title":"Env"},"completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Only completed (true) or still running (false) runs.","title":"Completed"},"created_after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs created after this ISO 8601 time.","title":"Created After"},"created_before":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only runs created before this ISO 8601 time.","title":"Created Before"}},"required":["org_id"],"title":"list_pipeline_runsArguments","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_environment_types":{"post":{"operationId":"list_environment_types","summary":"List environment types (for example development, staging, production) of the organization. Use for \"Which environment ty","description":"List environment types (for example development, staging, production) of the organization. Use for \"Which environment types does my Humanitec organization define\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"}},"required":["org_id"],"title":"list_environment_typesArguments","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_definitions":{"post":{"operationId":"list_resource_definitions","summary":"List resource definitions with type, driver, default flag and version. Driver inputs and secrets are not returned. Use f","description":"List resource definitions with type, driver, default flag and version. Driver inputs and secrets are not returned. Use for \"Which Humanitec resource definitions are configured for postgres\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"},"res_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only definitions for this resource type, for example postgres.","title":"Res Type"},"app":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only definitions that may match this application ID.","title":"App"},"env_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only definitions that may match this environment type.","title":"Env Type"}},"required":["org_id"],"title":"list_resource_definitionsArguments","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_types":{"post":{"operationId":"list_resource_types","summary":"List resource types available in the organization with category and use. Use for \"Which resource types can I request in ","description":"List resource types available in the organization with category and use. Use for \"Which resource types can I request in Humanitec\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"description":"ID of the Humanitec organization, as returned by list_organizations.","maxLength":200,"title":"Org Id","type":"string"}},"required":["org_id"],"title":"list_resource_typesArguments","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}}}}