---
title: "Get a Deployment Set"
method: GET
path: "/orgs/{orgId}/apps/{appId}/sets/{setId}"
tags: ["public", "Set"]
---

# Get a Deployment Set

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

## Path parameters

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

## Query parameters

- `diff` string

## Response `200`

The Requested Deployment Set.

- union
  - SetResponse — A Deployment Set (or just "Set") defines all of the non-Environment specific configuration for Modules and External Resources. Each of these Modules or External Resources has a unique name. Deployment Sets are immutable and their ID is a cryptographic hash of their content. This means that a Deployment Set can be globally identified based on its ID. It also means that referencing a Deployment Set by ID will always return the same Deployment Set. Deployment Sets cannot be created directly, instead they are created by applying a Deployment Delta to an existing Deployment Set. **Basic Structure** ``` { "id": <ID of the Deployment Set>, "modules" : { <ID of Module> : { "profile": <Defines how the optional "spec" property is interpreted> "spec": { <Properties that depend on the "profile" property.> } "externals": { <External Resource Name> : { "type": <Resource Type>, "params": { <Properties which parametrize the resource depending on the Resource Type.> } } } } } } ``` For details about how the Humanitec provided profiles work, see (Deployment Set Profiles)[].
    - `id` string, required — The ID which is a hash of the content of the Deployment Set.
    - `modules` object, required — The Modules that make up the Set
    - `shared` object, required — Resources that are shared across the set
    - `version` integer, required — The version of the Deployment Set Schema to use. (Currently, only 0 is supported, and if omitted, version 0 is assumed.)
    - `workloads` object — The Workloads that make up the Set. A Set holding at least one Workload is deployed in Generic Mode. Omitted when the Set holds no Workloads.
  - PlainDeltaResponse — Similar to the delta response, except the id and metadata properties. **Basic Structure** ``` { "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> ] } } } ```
    - `modules` ModuleDeltasResponse, required — ModuleDeltas groups the different operations together.
      - `add` object, required
      - `remove` string[], required
      - `update` object, required
    - `shared` UpdateActionResponse[], required
      - `from` string
      - `op` string, required
      - `path` string, required
      - `value` unknown
    - `workloads` WorkloadDeltasResponse — WorkloadDeltas groups the different operations together.
      - `add` object, required
      - `remove` string[], required
      - `update` object, required

## Other responses

- `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)