Humanitec

Humanitec Public API

The public API from Humanitec — 141 operation(s) for public.

GitHub OpenAPI

Operations 213

GET /orgs/{orgId}/apps List all Applications in an Organization #
POST /orgs/{orgId}/apps Add a new Application to an Organization #
GET /orgs/{orgId}/apps/{appId} Get an existing Application #
PATCH /orgs/{orgId}/apps/{appId} Update metadata of an existing Application #
DELETE /orgs/{orgId}/apps/{appId} Delete an Application #
GET /orgs/{orgId}/apps/{appId}/envs List all Environments #
POST /orgs/{orgId}/apps/{appId}/envs Add a new Environment to an Application #
GET /orgs/{orgId}/apps/{appId}/envs/{envId} Get a specific Environment #
PATCH /orgs/{orgId}/apps/{appId}/envs/{envId} Update a specific Environment #
DELETE /orgs/{orgId}/apps/{appId}/envs/{envId} Delete a specific Environment #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys List Deployments in an Environment #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys Start a new Deployment #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId} Get a specific Deployment #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId}/errors List errors that occurred in a Deployment #
PUT /orgs/{orgId}/apps/{appId}/envs/{envId}/from_deploy_id Rebase to a different Deployment #
GET /orgs/{orgId}/env-types List all Environment Types #
POST /orgs/{orgId}/env-types Add a new Environment Type #
GET /orgs/{orgId}/env-types/{envTypeId} Get an Environment Type #
DELETE /orgs/{orgId}/env-types/{envTypeId} Deletes an Environment Type #
PATCH /orgs/{orgId}/env-types/{envTypeId} Updates Environment Type #
GET /orgs/{orgId}/artefact-versions List all Artefacts Versions in the org #
POST /orgs/{orgId}/artefact-versions Register a new Artefact Version with your organization #
GET /orgs/{orgId}/artefact-versions/{artefactVersionId} Get an Artefacts Versions #
GET /orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-spec Get the spec of this Workload Artefact Version #
GET /orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-deployment-set Get the Humanitec module definition of this Workload Artefact Version as a… #
GET /orgs/{orgId}/artefacts List all Artefacts #
DELETE /orgs/{orgId}/artefacts/{artefactId} Delete Artefact and all related Artefact Versions #
GET /orgs/{orgId}/artefacts/{artefactId}/versions List all Artefact Versions of an Artefact #
PATCH /orgs/{orgId}/artefacts/{artefactId}/versions/{versionId} Update Version of an Artefact #
GET /orgs/{orgId}/images List all Container Images #
GET /orgs/{orgId}/images/{imageId} Get a specific Image Object #
GET /orgs/{orgId}/images/{imageId}/builds Lists all the Builds of an Image #
POST /orgs/{orgId}/images/{imageId}/builds Add a new Image Build #
POST /orgs/{orgId}/artefact-versions/convert-score Convert a Score specification, optional overrides, and extensions into the… #
GET /orgs/{orgId}/audit-logs List audit log entries by Organization #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/rules List all Automation Rules in an Environment #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/rules Create a new Automation Rule for an Environment #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId} Get a specific Automation Rule for an Environment #
PUT /orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId} Update an existing Automation Rule for an Environment #
DELETE /orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId} Delete Automation Rule from an Environment #
GET /orgs/{orgId}/apps/{appId}/deltas List Deltas in an Application #
POST /orgs/{orgId}/apps/{appId}/deltas Create a new Delta #
GET /orgs/{orgId}/apps/{appId}/deltas/{deltaId} Fetch an existing Delta #
PATCH /orgs/{orgId}/apps/{appId}/deltas/{deltaId} Update an existing Delta #
PUT /orgs/{orgId}/apps/{appId}/deltas/{deltaId} Update an existing Delta #
PUT /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/archived Mark a Delta as "archived" #
PUT /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/env_id Change the Environment of a Delta #
PUT /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/name Change the name of a Delta #
GET /orgs/{orgId}/apps/{appId}/sets Get all Deployment Sets #
GET /orgs/{orgId}/apps/{appId}/sets/{setId} Get a Deployment Set #
POST /orgs/{orgId}/apps/{appId}/sets/{setId} Apply a Deployment Delta to a Deployment Set #
GET /orgs/{orgId}/apps/{appId}/sets/{setId}/resources Get Resource Inputs for the given Deployment Set #
GET /orgs/{orgId}/apps/{appId}/sets/{setId}/diff/{sourceSetId} Get the difference between 2 Deployment Sets #
DELETE /orgs/{orgId}/apps/{appId}/jobs Deletes all Jobs for the Application #
GET /orgs/{orgId}/apps/{appId}/webhooks List Webhooks #
POST /orgs/{orgId}/apps/{appId}/webhooks Create a new Webhook #
GET /orgs/{orgId}/apps/{appId}/webhooks/{jobId} Get a Webhook #
DELETE /orgs/{orgId}/apps/{appId}/webhooks/{jobId} Delete a Webhook #
PATCH /orgs/{orgId}/apps/{appId}/webhooks/{jobId} Update a Webhook #
GET /orgs/{orgId}/events List Events #
POST /orgs/{orgId}/keys Associate a new RSA public key to an organization #
GET /orgs/{orgId}/keys List all public keys associated to an organization #
DELETE /orgs/{orgId}/keys/{keyId} Delete a public key associated to an organization #
GET /orgs/{orgId}/keys/{keyId} Retrieve a single public key associated to an organization #
GET /orgs/{orgId}/humanitec-keys List all the public keys Humanitec shares with an organization #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/logs Get container log entries for the environment #
GET /orgs List active organizations the user has access to #
GET /orgs/{orgId} Get the specified Organization #
GET /orgs/{orgId}/pipelines List all Pipelines within an Organization. This can be filtered by Application #
GET /orgs/{orgId}/apps/{appId}/pipelines List Pipelines within an Application #
POST /orgs/{orgId}/apps/{appId}/pipelines Create a Pipeline within an Application #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId} Get a Pipeline within an Application #
PATCH /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId} update a Pipeline within an Application #
DELETE /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId} Delete a pipeline within an application #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/versions List all versions of the pipeline #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/schema Get a pipeline schema #
GET /orgs/{orgId}/apps/{appId}/pipeline-criteria List the trigger matching criteria defined for Pipelines in this Application #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/criteria Create a new trigger matching criteria for this Pipeline #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/criteria/{criteriaId} Get the Pipeline Criteria with the given id #
DELETE /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/criteria/{criteriaId} Delete the Pipeline Criteria with the given id #
GET /orgs/{orgId}/pipeline-schemas/latest Gets the latest pipeline schema #
GET /orgs/{orgId}/pipeline-runs List all pipeline runs within the Org ordered newest to oldest. #
POST /orgs/{orgId}/apps/{appId}/pipeline-runs Create a Pipeline Run in the appropriate Pipeline based on the trigger and… #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs List runs within a pipeline ordered newest to oldest #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs Create a run within a pipeline #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId} Get a run within an pipeline #
DELETE /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId} Deleting a completed Run within a Pipeline #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/cancel Cancel a Run within an Pipeline #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/restart Restart a Run within an Pipeline by cloning it with the same trigger and inputs #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs List the details of the jobs within a pipeline run #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs/{jobId} List the details of a Job including Step information #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs/{jobId}/steps/{stepIndex}/logs Get a page of log output for a given step within a job #
GET /orgs/{orgId}/apps/{appId}/approvals List of the approval requests #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs/{jobId}/approvals/{approvalId} Get an approval request #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs/{jobId}/approvals/{approvalId}/approve Approve the approval request #
POST /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/runs/{runId}/jobs/{jobId}/approvals/{approvalId}/deny Deny the approval request #
GET /orgs/{orgId}/apps/{appId}/pipelines/{pipelineId}/batches/{batchType} Read the current state of a trigger batch #
GET /orgs/{orgId}/registries Lists available registries for the organization #
POST /orgs/{orgId}/registries Creates a new registry record #
GET /orgs/{orgId}/registries/{regId} Loads a registry record details #
DELETE /orgs/{orgId}/registries/{regId} Deletes an existing registry record and all associated credentials and secrets #
PATCH /orgs/{orgId}/registries/{regId} Updates (patches) an existing registry record #
GET /orgs/{orgId}/registries/{regId}/creds Returns current account credentials or secret details for the registry #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/resources List Active Resources provisioned in an environment #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/resources/graph Lists the resource objects that hold the information needed to provision the… #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/resources/graphs Create a Dependency Graph which is composed by the resource objects that hold… #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/resources/graphs/{graphId} Retrieve a Dependency Graph by its ID #
DELETE /orgs/{orgId}/apps/{appId}/envs/{envId}/resources/{type}/{resId} Delete Active Resource #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/resources/{type}/{resId}/actions/pin Pin Active Resource to a target Resource Definition Version #
GET /orgs/{orgId}/resources/account-types List Resource Account Types available to the organization #
GET /orgs/{orgId}/resources/accounts List Resource Accounts in the organization #
POST /orgs/{orgId}/resources/accounts Create a new Resource Account in the organization #
GET /orgs/{orgId}/resources/accounts/{accId} Get a Resource Account #
DELETE /orgs/{orgId}/resources/accounts/{accId} Delete an unused Resource Account #
PATCH /orgs/{orgId}/resources/accounts/{accId} Update a Resource Account #
POST /orgs/{orgId}/resources/accounts/{accId}/actions/check Check the credentials of an existing Resource Account #
GET /orgs/{orgId}/resources/defs List Resource Definitions #
POST /orgs/{orgId}/resources/defs Create a new Resource Definition #
GET /orgs/{orgId}/resources/defs/{defId} Get a Resource Definition #
PUT /orgs/{orgId}/resources/defs/{defId} Update a Resource Definition #
DELETE /orgs/{orgId}/resources/defs/{defId} Delete a Resource Definition #
PATCH /orgs/{orgId}/resources/defs/{defId} Update a Resource Definition #
GET /orgs/{orgId}/resources/defs/{defId}/versions Get Versions of a Resource Definition #
GET /orgs/{orgId}/resources/defs/{defId}/versions/{defVersionId} Get a Resource Definition Version #
POST /orgs/{orgId}/resources/defs/{defId}/versions/{defVersionId}/actions/archive Mark/unmark the Resource Definition Version as archived #
POST /orgs/{orgId}/resources/defs/{defId}/versions/{defVersionId}/actions/promote Promote the Resource Definition Version as active #
PUT /orgs/{orgId}/resources/defs/{defId}/criteria Update all Matching Criteria of a Resource Definition #
POST /orgs/{orgId}/resources/defs/{defId}/criteria Add a new Matching Criteria to a Resource Definition #
DELETE /orgs/{orgId}/resources/defs/{defId}/criteria/{criteriaId} Delete a Matching Criteria from a Resource Definition #
GET /orgs/{orgId}/resources/defs/{defId}/resources List Active Resources provisioned via a specific Resource Definition #
GET /orgs/{orgId}/resources/drivers List Resource Drivers #
POST /orgs/{orgId}/resources/drivers Register a new Resource Driver #
GET /orgs/{orgId}/resources/drivers/{driverId} Get a Resource Driver #
PUT /orgs/{orgId}/resources/drivers/{driverId} Update a Resource Driver #
DELETE /orgs/{orgId}/resources/drivers/{driverId} Delete a Resources Driver #
GET /orgs/{orgId}/resources/types List Resource Types #
POST /orgs/{orgId}/resources/types Creates a new Resources Type #
DELETE /orgs/{orgId}/resources/types/{typeId} Delete a Resource Type #
PATCH /orgs/{orgId}/resources/types/{typeId} Update a Resource Type #
PUT /orgs/{orgId}/resources/types/{typeId} Update a Resource Type #
GET /orgs/{orgId}/resources/classes List resource classes #
POST /orgs/{orgId}/resources/types/{typeId}/classes Creates a new resources class #
GET /orgs/{orgId}/resources/types/{typeId}/classes/{classId} Get resource class by ID #
PATCH /orgs/{orgId}/resources/types/{typeId}/classes/{classId} Update a resource class description #
DELETE /orgs/{orgId}/resources/types/{typeId}/classes/{classId} Delete a resource class #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/runtime Get Runtime information about the environment #
PUT /orgs/{orgId}/apps/{appId}/envs/{envId}/runtime/paused Pause / Resume an environment #
PATCH /orgs/{orgId}/apps/{appId}/envs/{envId}/runtime/replicas Set number of replicas for an environment's modules #
GET /orgs/{orgId}/apps/{appId}/runtime Get Runtime information about specific multiple environments #
POST /orgs/{orgId}/runtime/actions/check-connectivity Provision and check the cluster connectivity in an environment #
GET /orgs/{orgId}/secretstores Get list of Secret Stores for the given organization #
POST /orgs/{orgId}/secretstores Create a Secret Store for the given organization #
GET /orgs/{orgId}/secretstores/{storeId} Get the Secret Store #
DELETE /orgs/{orgId}/secretstores/{storeId} Delete the Secret Store #
PATCH /orgs/{orgId}/secretstores/{storeId} Update the Secret Store #
GET /current-user Gets the extended profile of the current user #
PATCH /current-user Updates the extended profile of the current user #
POST /orgs/{orgId}/groups Create a group in an organization #
GET /orgs/{orgId}/groups/{groupId}/users List users in a group #
GET /orgs/{orgId}/apps/{appId}/users List Users or Groups with roles in an App #
POST /orgs/{orgId}/apps/{appId}/users Adds a User or a Group to an Application with a Role #
GET /orgs/{orgId}/apps/{appId}/users/{userId} Get the role of a User or a Group on an Application #
DELETE /orgs/{orgId}/apps/{appId}/users/{userId} Remove the role of a User or a Group on an Application #
PATCH /orgs/{orgId}/apps/{appId}/users/{userId} Update the role of a User or a Group on an Application #
GET /orgs/{orgId}/env-types/{envType}/users List Users and Groups with roles in an Environment Type #
POST /orgs/{orgId}/env-types/{envType}/users Adds a User or a Group to an Environment Type with a Role #
GET /orgs/{orgId}/env-types/{envType}/users/{userId} Get the role of a User or a Group on an Environment Type #
DELETE /orgs/{orgId}/env-types/{envType}/users/{userId} Remove the role of a User or a Group on an Environment Type #
PATCH /orgs/{orgId}/env-types/{envType}/users/{userId} Update the role of a User or a Group on an Environment Type #
GET /orgs/{orgId}/invitations List the invites issued for the organization #
POST /orgs/{orgId}/invitations Invites a user to an Organization with a specified role #
GET /orgs/{orgId}/users List Users and Groups with roles in an Organization #
POST /orgs/{orgId}/users Creates a new service user #
GET /orgs/{orgId}/users/{userId} Get the role of a User or a Group on an Organization #
DELETE /orgs/{orgId}/users/{userId} Remove the role of a User or a Group on an Organization #
PATCH /orgs/{orgId}/users/{userId} Update the role of a User or a Group on an Organization #
GET /orgs/{orgId}/users/{userId}/groups Get the groups in an organization a user belongs to #
GET /users/{userId}/tokens Lists tokens associated with a user #
POST /users/{userId}/tokens Creates a new static token for a user #
GET /users/{userId}/tokens/{tokenId} Gets a specific token associated with a user #
DELETE /users/{userId}/tokens/{tokenId} Deletes a specific token associated with a user #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/value-set-versions List Value Set Versions in an Environment of an App #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/value-set-versions/{valueSetVersionId} Get a single Value Set Version in an Environment of an App. #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/value-set-versions/{valueSetVersionId}/purge/{key} Purge the value of a specific Shared Value from the App Environment Version… #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/value-set-versions/{valueSetVersionId}/restore Restore a Value Set Version in an Environment of an App #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/value-set-versions/{valueSetVersionId}/restore/{key} Restore a specific key from the Value Set Version in an Environment of an App #
GET /orgs/{orgId}/apps/{appId}/envs/{envId}/values List Shared Values in an Environment #
POST /orgs/{orgId}/apps/{appId}/envs/{envId}/values Create a Shared Value for an Environment #
DELETE /orgs/{orgId}/apps/{appId}/envs/{envId}/values Delete all Shared Value for an Environment #
PUT /orgs/{orgId}/apps/{appId}/envs/{envId}/values/{key} Update Shared Value for an Environment #
DELETE /orgs/{orgId}/apps/{appId}/envs/{envId}/values/{key} Delete Shared Value for an Environment #
PATCH /orgs/{orgId}/apps/{appId}/envs/{envId}/values/{key} Update Shared Value for an Environment #
GET /orgs/{orgId}/apps/{appId}/value-set-versions List Value Set Versions in the App #
GET /orgs/{orgId}/apps/{appId}/value-set-versions/{valueSetVersionId} Get a single Value Set Version from the App #
POST /orgs/{orgId}/apps/{appId}/value-set-versions/{valueSetVersionId}/purge/{key} Purge the value of a specific Shared Value from the App Version history #
POST /orgs/{orgId}/apps/{appId}/value-set-versions/{valueSetVersionId}/restore Restore a Value Set Version in an App #
POST /orgs/{orgId}/apps/{appId}/value-set-versions/{valueSetVersionId}/restore/{key} Restore a specific key from the Value Set Version in an App #
GET /orgs/{orgId}/apps/{appId}/values List Shared Values in an Application #
POST /orgs/{orgId}/apps/{appId}/values Create a Shared Value for an Application #
DELETE /orgs/{orgId}/apps/{appId}/values Delete all Shared Value for an App #
PUT /orgs/{orgId}/apps/{appId}/values/{key} Update Shared Value for an Application #
DELETE /orgs/{orgId}/apps/{appId}/values/{key} Delete Shared Value for an Application #
PATCH /orgs/{orgId}/apps/{appId}/values/{key} Update Shared Value for an Application #
GET /orgs/{orgId}/workload-profile-features List workload profile features available to the organization #
GET /orgs/{orgId}/workload-profiles List workload profiles available to the organization #
POST /orgs/{orgId}/workload-profiles Create new Workload Profile #
GET /orgs/{orgId}/workload-profiles/{profileQid} Get a Workload Profile #
PUT /orgs/{orgId}/workload-profiles/{profileQid} Update a Workload Profile #
DELETE /orgs/{orgId}/workload-profiles/{profileQid} Delete a Workload Profile #
GET /orgs/{orgId}/workload-profiles/{profileQid}/versions List versions of the given workload profile #
GET /orgs/{orgId}/workload-profiles/{profileQid}/versions/latest Latest version of the given workload profile with optional constraint #
POST /orgs/{orgId}/workload-profile-chart-versions Add new Workload Profile Chart Version #
GET /orgs/{orgId}/workload-profile-chart-versions Workload Profile Chart Versions for the given organization #

Documentation

📖
Documentation
https://developer.humanitec.com/platform-orchestrator/reference/api-references/
📖
GettingStarted
https://developer.humanitec.com/introduction/overview/
📖
Authentication
https://developer.humanitec.com/platform-orchestrator/security/api-tokens/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/openapi/humanitec-public-api-openapi.yml

Other Resources

🔗
Rules
https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/humanitec-rules.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/humanitec-public-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

humanitec-public-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Humanitec Public API
  version: 0.28.24
  description: '# Introduction

    The *Humanitec API* allows you to automate and integrate Humanitec into your developer and operational workflows.'
  contact:
    name: Humanitec Support
    email: support@humanitec.com
  x-logo:
    url: humanitec-logo.png
    altText: Humanitec logo
servers:
- url: https://api.humanitec.io/
tags:


# --- truncated at 32 KB (488 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/openapi/humanitec-public-api-openapi.yml