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
What You Can Do
MCP Tools
createagent
Register a new Agent under an Organization.
listagents
List all the agents in an Organization.
deleteagent
Delete an Agent (and its keys) stored under an Organization.
patchagent
Update the description of an Agent.
listkeysinagent
List all the keys registered under an Agent in an Organization.
createkey
Register a new Key under an Agent in an Organization.
deletekeyinagent
Delete a key registered under a Agent.
listapplications
List all Applications in an Organization.
createapplication
Add a new Application to an Organization
getapplication
Get an existing Application
patchapplication
Update metadata of an existing Application
deleteapplication
Delete an Application
listenvironments
List all Environments.
createenvironment
Add a new Environment to an Application.
getenvironment
Get a specific Environment.
updateenvironment
Update a specific Environment.
deleteenvironment
Delete a specific Environment.
listdeployments
List Deployments in an Environment.
createdeployment
Start a new Deployment.
getdeployment
Get a specific Deployment.
listdeploymenterrors
List errors that occurred in a Deployment.
rebaseenvironment
Rebase to a different Deployment.
listenvironmenttypes
List all Environment Types
createenvironmenttype
Add a new Environment Type
getenvironmenttype
Get an Environment Type
deleteenvironmenttype
Deletes an Environment Type
updateenvironmenttype
Updates Environment Type
listartefactversionsinorg
List all Artefacts Versions in the org.
createartefactversion
Register a new Artefact Version with your organization.
getartefactversion
Get an Artefacts Versions.
getworkloadartefactversionspec
Get the spec of this Workload Artefact Version
getworkloadartefactversiondeploymentset
Get the Humanitec module definition of this Workload Artefact Version as a deployment set
listartefacts
List all Artefacts.
deleteartefact
Delete Artefact and all related Artefact Versions
listartefactversions
List all Artefact Versions of an Artefact.
patchartefactversion
Update Version of an Artefact.
listdeprecatedimages
List all Container Images
getdeprecatedimage
Get a specific Image Object
listdeprecatedimagebuilds
Lists all the Builds of an Image
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
listautomationrules
List all Automation Rules in an Environment.
createautomationrule
Create a new Automation Rule for an Environment.
getautomationrule
Get a specific Automation Rule for an Environment.
updateautomationrule
Update an existing Automation Rule for an Environment.
deleteautomationrule
Delete Automation Rule from an Environment.
listdeltas
List Deltas in an Application
createdelta
Create a new Delta
getdelta
Fetch an existing Delta
patchdelta
Update an existing Delta
putdelta
Update an existing Delta
archivedelta
Mark a Delta as "archived"
changeenvofdelta
Change the Environment of a Delta
changenameofdelta
Change the name of a Delta
listsets
Get all Deployment Sets
getset
Get a Deployment Set
updateset
Apply a Deployment Delta to a Deployment Set
getsetresourceinputs
Get Resource Inputs for the given Deployment Set
getdiff
Get the difference between 2 Deployment Sets