# Humanitec Delta API

**Canonical:** https://apis.io/apis/humanitec/humanitec-delta-api/  
**Provider:** Humanitec — https://apis.io/providers/humanitec/  
**Base URL:** https://api.humanitec.io  
**Documentation:** https://developer.humanitec.com/platform-orchestrator/reference/api-references/

Humanitec Delta API is one of 45 APIs that [Humanitec](https://apis.io/providers/humanitec/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Delta. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

A Deployment Delta (or just "Delta") describes the changes that must be applied to one Deployment Set to generate another Deployment Set. Deployment Deltas are the only way to create new Deployment Sets. Deployment Deltas can be created fully formed or combined together via PATCHing. They can also be generated from the difference between two Deployment Sets. **Basic Structure** ``` { "id": <ID of the Deployment Delta.>, "metadata": { <Properties such as who created the Delta, which Environment it is associated to and a Human-friendly name> } "modules" : { "add" : { <ID of Module to add to the Deployment Set> : { <An entire Modules object> } }, "remove": [ <An array of Module IDs that should be removed from the Deployment Set> ], "update": { <ID of Module already in the Set to be updated> : [ <An array of JSON Patch (Search Results (RFC 6902) objects scoped to the module> ] } } } ``` <SchemaDefinition schemaRef="#/components/schemas/DeltaRequest" />

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/openapi/humanitec-delta-api-openapi.yml
- **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/
- **Rules** — https://raw.githubusercontent.com/api-evangelist/humanitec/refs/heads/main/humanitec-rules.yml

## Other Humanitec APIs (12)

- [Humanitec AccountType API](https://apis.io/apis/humanitec/humanitec-accounttype-api/)
- [Humanitec ActiveResource API](https://apis.io/apis/humanitec/humanitec-activeresource-api/)
- [Humanitec Agents API](https://apis.io/apis/humanitec/humanitec-agents-api/)
- [Humanitec Application API](https://apis.io/apis/humanitec/humanitec-application-api/)
- [Humanitec Artefact API](https://apis.io/apis/humanitec/humanitec-artefact-api/)
- [Humanitec ArtefactVersion API](https://apis.io/apis/humanitec/humanitec-artefactversion-api/)
- [Humanitec AuditLogs API](https://apis.io/apis/humanitec/humanitec-auditlogs-api/)
- [Humanitec AutomationRule API](https://apis.io/apis/humanitec/humanitec-automationrule-api/)
- [Humanitec Deployment API](https://apis.io/apis/humanitec/humanitec-deployment-api/)
- [Humanitec DriverDefinition API](https://apis.io/apis/humanitec/humanitec-driverdefinition-api/)
- [Humanitec Environment API](https://apis.io/apis/humanitec/humanitec-environment-api/)
- [Humanitec EnvironmentPausedInfo API](https://apis.io/apis/humanitec/humanitec-environmentpausedinfo-api/)

## Tags

Delta

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/humanitec/humanitec-delta-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/humanitec/.