---
title: "Apply a Deployment Delta to a Deployment Set"
method: POST
path: "/orgs/{orgId}/apps/{appId}/sets/{setId}"
tags: ["public", "Set"]
---

# Apply a Deployment Delta to a Deployment Set

`POST /orgs/{orgId}/apps/{appId}/sets/{setId}`

## Path parameters

- `orgId` string, required
- `appId` string, required
- `setId` string, required

## Request body

- DeltaRequest — 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> ] } } } ```
  - `id` string — Ignored, but can be provided.
  - `metadata` DeltaMetadataRequest
    - `archived` boolean
    - `contributers` string[], nullable
    - `created_at` string, date-time
    - `created_by` string
    - `env_id` string
    - `last_modified_at` string, date-time
    - `name` string
    - `shared` boolean
  - `modules` ModuleDeltasRequest — ModuleDeltas groups the different operations together.
    - `add` object, nullable
    - `remove` string[], nullable
    - `update` object, nullable
  - `shared` UpdateActionRequest[], nullable
    - `from` string
    - `op` string
    - `path` string
    - `value` unknown
  - `workloads` WorkloadDeltasRequest — WorkloadDeltas groups the different operations together.
    - `add` object, nullable
    - `remove` string[], nullable
    - `update` object, nullable

## Response `200`

A Deployment Delta which if applied to the Set with ID `sourceSetId` gives the Set with ID `setId`.

- string

## Other responses

- `400` — Deployment Delta is incompatible with the Deployment Set specified by `setId`.
- `404` — No Deployment Set with ID `setId` found in Application.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)