---
title: "Update an existing Delta"
method: PUT
path: "/orgs/{orgId}/apps/{appId}/deltas/{deltaId}"
tags: ["public", "Delta"]
---

# Update an existing Delta

`PUT /orgs/{orgId}/apps/{appId}/deltas/{deltaId}`

## Path parameters

- `orgId` string, required
- `appId` string, required
- `deltaId` 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 `204`

The requested Deployment Delta.

## Other responses

- `400` — The request was invalid.
- `404` — No Deployment Delta with ID `deltaId` 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)