Humanitec · Capability

Humanitec API

# Introduction The *Humanitec API* allows you to automate and integrate Humanitec into your developer and operational workflows. The API is a REST based API. It is based around a set of concepts: * Core * External Resources * Sets and Deltas ## Authentication Almost all requests made to the Humanitec API require Authentication. See our [Developer Docs on API Authentication](https://developer.humanitec.com/platform-orchestrator/reference/api-references/#authentication) for instructions. ## Content Types The Humanitec API, unless explicitly specified, only accepts content types of `application/j

Run with Naftiko HumanitecAPI

What You Can Do

POST
Createagent — Register a new Agent under an Organization.
/orgs/{orgId}/agents
GET
Listagents — List all the agents in an Organization.
/orgs/{orgId}/agents
DELETE
Deleteagent — Delete an Agent (and its keys) stored under an Organization.
/orgs/{orgId}/agents/{agentId}
PATCH
Patchagent — Update the description of an Agent.
/orgs/{orgId}/agents/{agentId}
GET
Listkeysinagent — List all the keys registered under an Agent in an Organization.
/orgs/{orgId}/agents/{agentId}/keys
POST
Createkey — Register a new Key under an Agent in an Organization.
/orgs/{orgId}/agents/{agentId}/keys
DELETE
Deletekeyinagent — Delete a key registered under a Agent.
/orgs/{orgId}/agents/{agentId}/keys/{fingerprint}
GET
Listapplications — List all Applications in an Organization.
/orgs/{orgId}/apps
POST
Createapplication — Add a new Application to an Organization
/orgs/{orgId}/apps
GET
Getapplication — Get an existing Application
/orgs/{orgId}/apps/{appId}
PATCH
Patchapplication — Update metadata of an existing Application
/orgs/{orgId}/apps/{appId}
DELETE
Deleteapplication — Delete an Application
/orgs/{orgId}/apps/{appId}
GET
Listenvironments — List all Environments.
/orgs/{orgId}/apps/{appId}/envs
POST
Createenvironment — Add a new Environment to an Application.
/orgs/{orgId}/apps/{appId}/envs
GET
Getenvironment — Get a specific Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}
PATCH
Updateenvironment — Update a specific Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}
DELETE
Deleteenvironment — Delete a specific Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}
GET
Listdeployments — List Deployments in an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys
POST
Createdeployment — Start a new Deployment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys
GET
Getdeployment — Get a specific Deployment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId}
GET
Listdeploymenterrors — List errors that occurred in a Deployment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId}/errors
PUT
Rebaseenvironment — Rebase to a different Deployment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/from_deploy_id
GET
Listenvironmenttypes — List all Environment Types
/orgs/{orgId}/env-types
POST
Createenvironmenttype — Add a new Environment Type
/orgs/{orgId}/env-types
GET
Getenvironmenttype — Get an Environment Type
/orgs/{orgId}/env-types/{envTypeId}
DELETE
Deleteenvironmenttype — Deletes an Environment Type
/orgs/{orgId}/env-types/{envTypeId}
PATCH
Updateenvironmenttype — Updates Environment Type
/orgs/{orgId}/env-types/{envTypeId}
GET
Listartefactversionsinorg — List all Artefacts Versions in the org.
/orgs/{orgId}/artefact-versions
POST
Createartefactversion — Register a new Artefact Version with your organization.
/orgs/{orgId}/artefact-versions
GET
Getartefactversion — Get an Artefacts Versions.
/orgs/{orgId}/artefact-versions/{artefactVersionId}
GET
Getworkloadartefactversionspec — Get the spec of this Workload Artefact Version
/orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-spec
GET
Getworkloadartefactversiondeploymentset — Get the Humanitec module definition of this Workload Artefact Version as a deployment set
/orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-deployment-set
GET
Listartefacts — List all Artefacts.
/orgs/{orgId}/artefacts
DELETE
Deleteartefact — Delete Artefact and all related Artefact Versions
/orgs/{orgId}/artefacts/{artefactId}
GET
Listartefactversions — List all Artefact Versions of an Artefact.
/orgs/{orgId}/artefacts/{artefactId}/versions
PATCH
Patchartefactversion — Update Version of an Artefact.
/orgs/{orgId}/artefacts/{artefactId}/versions/{versionId}
GET
Listdeprecatedimages — List all Container Images
/orgs/{orgId}/images
GET
Getdeprecatedimage — Get a specific Image Object
/orgs/{orgId}/images/{imageId}
GET
Listdeprecatedimagebuilds — Lists all the Builds of an Image
/orgs/{orgId}/images/{imageId}/builds
POST
Createdeprecatedimagebuild — Add a new Image Build
/orgs/{orgId}/images/{imageId}/builds
POST
Convertscoretoset — Convert a Score specification, optional overrides, and extensions into the contents for a deployment set.
/orgs/{orgId}/artefact-versions/convert-score
GET
Listauditlogentries — List audit log entries by Organization
/orgs/{orgId}/audit-logs
GET
Listautomationrules — List all Automation Rules in an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/rules
POST
Createautomationrule — Create a new Automation Rule for an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/rules
GET
Getautomationrule — Get a specific Automation Rule for an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId}
PUT
Updateautomationrule — Update an existing Automation Rule for an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId}
DELETE
Deleteautomationrule — Delete Automation Rule from an Environment.
/orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId}
GET
Listdeltas — List Deltas in an Application
/orgs/{orgId}/apps/{appId}/deltas
POST
Createdelta — Create a new Delta
/orgs/{orgId}/apps/{appId}/deltas
GET
Getdelta — Fetch an existing Delta
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}
PATCH
Patchdelta — Update an existing Delta
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}
PUT
Putdelta — Update an existing Delta
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}
PUT
Archivedelta — Mark a Delta as "archived"
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/archived
PUT
Changeenvofdelta — Change the Environment of a Delta
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/env_id
PUT
Changenameofdelta — Change the name of a Delta
/orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/name
GET
Listsets — Get all Deployment Sets
/orgs/{orgId}/apps/{appId}/sets
GET
Getset — Get a Deployment Set
/orgs/{orgId}/apps/{appId}/sets/{setId}
POST
Updateset — Apply a Deployment Delta to a Deployment Set
/orgs/{orgId}/apps/{appId}/sets/{setId}
GET
Getsetresourceinputs — Get Resource Inputs for the given Deployment Set
/orgs/{orgId}/apps/{appId}/sets/{setId}/resources
GET
Getdiff — Get the difference between 2 Deployment Sets
/orgs/{orgId}/apps/{appId}/sets/{setId}/diff/{sourceSetId}

MCP Tools

createagent

Register a new Agent under an Organization.

listagents

List all the agents in an Organization.

read-only idempotent
deleteagent

Delete an Agent (and its keys) stored under an Organization.

idempotent
patchagent

Update the description of an Agent.

listkeysinagent

List all the keys registered under an Agent in an Organization.

read-only idempotent
createkey

Register a new Key under an Agent in an Organization.

deletekeyinagent

Delete a key registered under a Agent.

idempotent
listapplications

List all Applications in an Organization.

read-only idempotent
createapplication

Add a new Application to an Organization

getapplication

Get an existing Application

read-only idempotent
patchapplication

Update metadata of an existing Application

deleteapplication

Delete an Application

idempotent
listenvironments

List all Environments.

read-only idempotent
createenvironment

Add a new Environment to an Application.

getenvironment

Get a specific Environment.

read-only idempotent
updateenvironment

Update a specific Environment.

deleteenvironment

Delete a specific Environment.

idempotent
listdeployments

List Deployments in an Environment.

read-only idempotent
createdeployment

Start a new Deployment.

getdeployment

Get a specific Deployment.

read-only idempotent
listdeploymenterrors

List errors that occurred in a Deployment.

read-only idempotent
rebaseenvironment

Rebase to a different Deployment.

idempotent
listenvironmenttypes

List all Environment Types

read-only idempotent
createenvironmenttype

Add a new Environment Type

getenvironmenttype

Get an Environment Type

read-only idempotent
deleteenvironmenttype

Deletes an Environment Type

idempotent
updateenvironmenttype

Updates Environment Type

listartefactversionsinorg

List all Artefacts Versions in the org.

read-only idempotent
createartefactversion

Register a new Artefact Version with your organization.

getartefactversion

Get an Artefacts Versions.

read-only idempotent
getworkloadartefactversionspec

Get the spec of this Workload Artefact Version

read-only idempotent
getworkloadartefactversiondeploymentset

Get the Humanitec module definition of this Workload Artefact Version as a deployment set

read-only idempotent
listartefacts

List all Artefacts.

read-only idempotent
deleteartefact

Delete Artefact and all related Artefact Versions

idempotent
listartefactversions

List all Artefact Versions of an Artefact.

read-only idempotent
patchartefactversion

Update Version of an Artefact.

listdeprecatedimages

List all Container Images

read-only idempotent
getdeprecatedimage

Get a specific Image Object

read-only idempotent
listdeprecatedimagebuilds

Lists all the Builds of an Image

read-only idempotent
createdeprecatedimagebuild

Add a new Image Build

convertscoretoset

Convert a Score specification, optional overrides, and extensions into the contents for a deployment set.

listauditlogentries

List audit log entries by Organization

read-only idempotent
listautomationrules

List all Automation Rules in an Environment.

read-only idempotent
createautomationrule

Create a new Automation Rule for an Environment.

getautomationrule

Get a specific Automation Rule for an Environment.

read-only idempotent
updateautomationrule

Update an existing Automation Rule for an Environment.

idempotent
deleteautomationrule

Delete Automation Rule from an Environment.

idempotent
listdeltas

List Deltas in an Application

read-only idempotent
createdelta

Create a new Delta

getdelta

Fetch an existing Delta

read-only idempotent
patchdelta

Update an existing Delta

putdelta

Update an existing Delta

idempotent
archivedelta

Mark a Delta as "archived"

idempotent
changeenvofdelta

Change the Environment of a Delta

idempotent
changenameofdelta

Change the name of a Delta

idempotent
listsets

Get all Deployment Sets

read-only idempotent
getset

Get a Deployment Set

read-only idempotent
updateset

Apply a Deployment Delta to a Deployment Set

getsetresourceinputs

Get Resource Inputs for the given Deployment Set

read-only idempotent
getdiff

Get the difference between 2 Deployment Sets

read-only idempotent

Capability Spec

humanitec-capability.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Humanitec API
  description: '# Introduction The *Humanitec API* allows you to automate and integrate Humanitec into your developer and
    operational workflows. The API is a REST based API. It is based around a set of concepts: * Core * External Resources
    * Sets and Deltas ## Authentication Almost all requests made to the Humanitec API require Authentication. See our [Developer
    Docs on API Authentication](https://developer.humanitec.com/platform-orchestrator/reference/api-references/#authentication)
    for instructions. ## Content Types The Humanitec API, unless explicitly specified, only accepts content types of `application/j'
  tags:
  - Humanitec
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: humanitec
    baseUri: https://api.humanitec.io
    description: Humanitec API HTTP API.
    resources:
    - name: orgs-orgid-agents
      path: /orgs/{orgId}/agents
      operations:
      - name: createagent
        method: POST
        description: Register a new Agent under an Organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listagents
        method: GET
        description: List all the agents in an Organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-agents-agentid
      path: /orgs/{orgId}/agents/{agentId}
      operations:
      - name: deleteagent
        method: DELETE
        description: Delete an Agent (and its keys) stored under an Organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchagent
        method: PATCH
        description: Update the description of an Agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-agents-agentid-keys
      path: /orgs/{orgId}/agents/{agentId}/keys
      operations:
      - name: listkeysinagent
        method: GET
        description: List all the keys registered under an Agent in an Organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createkey
        method: POST
        description: Register a new Key under an Agent in an Organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-agents-agentid-keys-fingerprint
      path: /orgs/{orgId}/agents/{agentId}/keys/{fingerprint}
      operations:
      - name: deletekeyinagent
        method: DELETE
        description: Delete a key registered under a Agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps
      path: /orgs/{orgId}/apps
      operations:
      - name: listapplications
        method: GET
        description: List all Applications in an Organization.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createapplication
        method: POST
        description: Add a new Application to an Organization
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid
      path: /orgs/{orgId}/apps/{appId}
      operations:
      - name: getapplication
        method: GET
        description: Get an existing Application
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchapplication
        method: PATCH
        description: Update metadata of an existing Application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteapplication
        method: DELETE
        description: Delete an Application
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs
      path: /orgs/{orgId}/apps/{appId}/envs
      operations:
      - name: listenvironments
        method: GET
        description: List all Environments.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createenvironment
        method: POST
        description: Add a new Environment to an Application.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}
      operations:
      - name: getenvironment
        method: GET
        description: Get a specific Environment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateenvironment
        method: PATCH
        description: Update a specific Environment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteenvironment
        method: DELETE
        description: Delete a specific Environment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-deploys
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys
      operations:
      - name: listdeployments
        method: GET
        description: List Deployments in an Environment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        - name: pipelineRunId
          in: query
          type: string
          description: An optional filter by the Pipeline and Pipeline Run ID separated by a comma.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createdeployment
        method: POST
        description: Start a new Deployment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-deploys-deployi
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId}
      operations:
      - name: getdeployment
        method: GET
        description: Get a specific Deployment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        - name: deployId
          in: path
          type: string
          required: true
          description: The Deployment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-deploys-deployi
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/deploys/{deployId}/errors
      operations:
      - name: listdeploymenterrors
        method: GET
        description: List errors that occurred in a Deployment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        - name: deployId
          in: path
          type: string
          required: true
          description: The Deployment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-from-deploy-id
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/from_deploy_id
      operations:
      - name: rebaseenvironment
        method: PUT
        description: Rebase to a different Deployment.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: appId
          in: path
          type: string
          required: true
          description: The Application ID.
        - name: envId
          in: path
          type: string
          required: true
          description: The Environment ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-env-types
      path: /orgs/{orgId}/env-types
      operations:
      - name: listenvironmenttypes
        method: GET
        description: List all Environment Types
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createenvironmenttype
        method: POST
        description: Add a new Environment Type
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-env-types-envtypeid
      path: /orgs/{orgId}/env-types/{envTypeId}
      operations:
      - name: getenvironmenttype
        method: GET
        description: Get an Environment Type
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: envTypeId
          in: path
          type: string
          required: true
          description: ID of the Environment Type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteenvironmenttype
        method: DELETE
        description: Deletes an Environment Type
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: envTypeId
          in: path
          type: string
          required: true
          description: ID of the Environment Type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateenvironmenttype
        method: PATCH
        description: Updates Environment Type
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The Organization ID.
        - name: envTypeId
          in: path
          type: string
          required: true
          description: ID of the Environment Type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefact-versions
      path: /orgs/{orgId}/artefact-versions
      operations:
      - name: listartefactversionsinorg
        method: GET
        description: List all Artefacts Versions in the org.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: name
          in: query
          type: string
          description: (Optional) Filter Artefact Versions by name.
        - name: reference
          in: query
          type: string
          description: (Optional) Filter Artefact Versions by the reference to a Version of the same Artefact. This cannot
            be used together with `name`.
        - name: archived
          in: query
          type: boolean
          description: (Optional) Filter for non-archived Artefact Versions. If no filter is defined only non-archived Artefact
            Versions are returned, if the filter is true both archi
        - name: type
          in: query
          type: string
          description: (Optional) Filter by artefact type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createartefactversion
        method: POST
        description: Register a new Artefact Version with your organization.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: vcs
          in: query
          type: string
          description: (Optional) Which version control system the version comes from. Default value is "git". If this parameter
            is not supplied or its value is "git", the provided re
        - name: dry_run
          in: query
          type: boolean
          description: Optionally validate the request but do not persist the actual artefact. If the Accept type is set to
            "application/x.workload-deployment-set+json" or "applicatio
        - name: Accept
          in: header
          type: string
          description: Indicates which content types the client is able to understand.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefact-versions-artefactversionid
      path: /orgs/{orgId}/artefact-versions/{artefactVersionId}
      operations:
      - name: getartefactversion
        method: GET
        description: Get an Artefacts Versions.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactVersionId
          in: path
          type: string
          required: true
          description: The Artefact Version ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefact-versions-artefactversionid-w
      path: /orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-spec
      operations:
      - name: getworkloadartefactversionspec
        method: GET
        description: Get the spec of this Workload Artefact Version
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactVersionId
          in: path
          type: string
          required: true
          description: The Artefact Version ID.
        - name: Accept
          in: header
          type: string
          description: The accepted content type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefact-versions-artefactversionid-w
      path: /orgs/{orgId}/artefact-versions/{artefactVersionId}/workload-deployment-set
      operations:
      - name: getworkloadartefactversiondeploymentset
        method: GET
        description: Get the Humanitec module definition of this Workload Artefact Version as a deployment set
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactVersionId
          in: path
          type: string
          required: true
          description: The Artefact Version ID.
        - name: Accept
          in: header
          type: string
          description: The accepted content type.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefacts
      path: /orgs/{orgId}/artefacts
      operations:
      - name: listartefacts
        method: GET
        description: List all Artefacts.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: type
          in: query
          type: string
          description: (Optional) Filter Artefacts by type.
        - name: name
          in: query
          type: string
          description: (Optional) Filter Artefacts by name.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefacts-artefactid
      path: /orgs/{orgId}/artefacts/{artefactId}
      operations:
      - name: deleteartefact
        method: DELETE
        description: Delete Artefact and all related Artefact Versions
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactId
          in: path
          type: string
          required: true
          description: The Artefact ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefacts-artefactid-versions
      path: /orgs/{orgId}/artefacts/{artefactId}/versions
      operations:
      - name: listartefactversions
        method: GET
        description: List all Artefact Versions of an Artefact.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactId
          in: path
          type: string
          required: true
          description: The Artefact ID.
        - name: archived
          in: query
          type: boolean
          description: (Optional) Filter for non-archived Artefact Versions. If no filter is defined only non-archived Artefact
            Versions are returned, if the filter is true both archi
        - name: reference
          in: query
          type: string
          description: (Optional) Filter Artefact Versions by by name including a version or digest.
        - name: limit
          in: query
          type: integer
          description: (Optional) Limit the number of versions returned by the endpoint.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefacts-artefactid-versions-version
      path: /orgs/{orgId}/artefacts/{artefactId}/versions/{versionId}
      operations:
      - name: patchartefactversion
        method: PATCH
        description: Update Version of an Artefact.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: artefactId
          in: path
          type: string
          required: true
          description: The Artefact ID.
        - name: versionId
          in: path
          type: string
          required: true
          description: The Version ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-images
      path: /orgs/{orgId}/images
      operations:
      - name: listdeprecatedimages
        method: GET
        description: List all Container Images
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-images-imageid
      path: /orgs/{orgId}/images/{imageId}
      operations:
      - name: getdeprecatedimage
        method: GET
        description: Get a specific Image Object
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: imageId
          in: path
          type: string
          required: true
          description: The Image ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-images-imageid-builds
      path: /orgs/{orgId}/images/{imageId}/builds
      operations:
      - name: listdeprecatedimagebuilds
        method: GET
        description: Lists all the Builds of an Image
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: imageId
          in: path
          type: string
          required: true
          description: The Image ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createdeprecatedimagebuild
        method: POST
        description: Add a new Image Build
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        - name: imageId
          in: path
          type: string
          required: true
          description: The Image ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-artefact-versions-convert-score
      path: /orgs/{orgId}/artefact-versions/convert-score
      operations:
      - name: convertscoretoset
        method: POST
        description: Convert a Score specification, optional overrides, and extensions into the contents for a deployment
          set.
        inputParameters:
        - name: orgId
          in: path
          type: string
          required: true
          description: The organization ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-audit-logs
      path: /orgs/{orgId}/audit-logs
      operations:
      - name: listauditlogentries
        method: GET
        description: List audit log entries by Organization
        inputParameters:
        - name: from
          in: query
          type: string
          description: Optional filter for entries created after the given time.
        - name: to
          in: query
          type: string
          description: Optional filter for entries created before the given time.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-rules
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/rules
      operations:
      - name: listautomationrules
        method: GET
        description: List all Automation Rules in an Environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createautomationrule
        method: POST
        description: Create a new Automation Rule for an Environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-envs-envid-rules-ruleid
      path: /orgs/{orgId}/apps/{appId}/envs/{envId}/rules/{ruleId}
      operations:
      - name: getautomationrule
        method: GET
        description: Get a specific Automation Rule for an Environment.
        inputParameters:
        - name: ruleId
          in: path
          type: string
          required: true
          description: The Automation Rule ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateautomationrule
        method: PUT
        description: Update an existing Automation Rule for an Environment.
        inputParameters:
        - name: ruleId
          in: path
          type: string
          required: true
          description: The Automation Rule ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteautomationrule
        method: DELETE
        description: Delete Automation Rule from an Environment.
        inputParameters:
        - name: ruleId
          in: path
          type: string
          required: true
          description: The Automation Rule ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-deltas
      path: /orgs/{orgId}/apps/{appId}/deltas
      operations:
      - name: listdeltas
        method: GET
        description: List Deltas in an Application
        inputParameters:
        - name: archived
          in: query
          type: boolean
          description: If true, return archived Deltas.
        - name: env
          in: query
          type: string
          description: Only return Deltas associated with the specified Environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createdelta
        method: POST
        description: Create a new Delta
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-deltas-deltaid
      path: /orgs/{orgId}/apps/{appId}/deltas/{deltaId}
      operations:
      - name: getdelta
        method: GET
        description: Fetch an existing Delta
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Delta to fetch.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchdelta
        method: PATCH
        description: Update an existing Delta
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Delta to update.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: putdelta
        method: PUT
        description: Update an existing Delta
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Delta to update.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-deltas-deltaid-metadata-ar
      path: /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/archived
      operations:
      - name: archivedelta
        method: PUT
        description: Mark a Delta as "archived"
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Deployment Delta.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-deltas-deltaid-metadata-en
      path: /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/env_id
      operations:
      - name: changeenvofdelta
        method: PUT
        description: Change the Environment of a Delta
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Deployment Delta.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-deltas-deltaid-metadata-na
      path: /orgs/{orgId}/apps/{appId}/deltas/{deltaId}/metadata/name
      operations:
      - name: changenameofdelta
        method: PUT
        description: Change the name of a Delta
        inputParameters:
        - name: deltaId
          in: path
          type: string
          required: true
          description: ID of the Deployment Delta.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-orgid-apps-appid-sets
      path: /orgs/{orgId}/apps/{appId}/sets
      operations:
      - name: listsets
        method: GET
        description: Get all Deployment Sets
        outpu

# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/capabilities/humanitec-capability.yaml