---
title: "Create a configuration set"
method: POST
path: "/configuration-sets"
tags: ["Configuration"]
---

# Create a configuration set

`POST /configuration-sets`

## Request body

- ConfigurationApiCreateConfigurationSetRequestBody
  - `scope` 'organization' | 'project', required
  - `scopeId` string, required
  - `configurationProperties` ConfigurationPropertyRequest[]
    - `name` string, required
    - `value` string
    - `id` string — The ID of the configuration property. If provided, will act as an update. Otherwise, a new configuration property will be created.
    - `isSensitive` boolean
    - `isReadonly` boolean
    - `isRequired` boolean
    - `regex` string
    - `scopeId` string — The ID of the entity of the provided `scope`. e.g. a project's ID when the provided `scope` is `PROJECT`. Inapplicable for `GLOBAL` scope, as it has no specific entity.
    - `scope` 'SET' | 'GLOBAL' | 'BLUEPRINT' | 'SUB_ENVIRONMENT_BLUEPRINT' | 'PROJECT' | 'WORKFLOW' | 'ENVIRONMENT' | 'DEPLOYMENT' | 'SET' | 'GLOBAL' | 'BLUEPRINT' | 'SUB_ENVIRONMENT_BLUEPRINT' | 'PROJECT' | 'WORKFLOW' | 'ENVIRONMENT' | 'DEPLOYMENT' | 'SET' | 'GLOBAL' | 'BLUEPRINT' | 'SUB_ENVIRONMENT_BLUEPRINT' | 'PROJECT' | 'WORKFLOW' | 'ENVIRONMENT' | 'DEPLOYMENT' | 'SET' | 'GLOBAL' | 'BLUEPRINT' | 'SUB_ENVIRONMENT_BLUEPRINT' | 'PROJECT' | 'WORKFLOW' | 'ENVIRONMENT' | 'DEPLOYMENT' | 'SET' | 'GLOBAL' | 'BLUEPRINT' | 'SUB_ENVIRONMENT_BLUEPRINT' | 'PROJECT' | 'WORKFLOW' | 'ENVIRONMENT' | 'DEPLOYMENT', required
    - `type` 0 | 1 | 0 | 1 | 0 | 1 | 0 | 1 | 0 | 1, required
    - `toDelete` boolean
    - `projectId` string
    - `organizationId` string, required
    - `schema` PartialJSONSchema7
      - `type` 'string' | 'array' | 'string' | 'array' | 'string' | 'array' | 'string' | 'array' | 'string' | 'array'
      - `enum` string[]
      - `format` 'HCL' | 'JSON' | 'ENVIRONMENT_OUTPUT' | 'HCL' | 'JSON' | 'ENVIRONMENT_OUTPUT' | 'HCL' | 'JSON' | 'ENVIRONMENT_OUTPUT' | 'HCL' | 'JSON' | 'ENVIRONMENT_OUTPUT' | 'HCL' | 'JSON' | 'ENVIRONMENT_OUTPUT'
    - `description` string
    - `isOutput` boolean
  - `name` string, required
  - `description` string

## Response `200`

- ConfigurationApiCreateConfigurationSetResponse
  - `id` string
  - `name` string, required
  - `description` string
  - `assignmentScopeId` string, required
  - `assignmentScope` 'organization' | 'project' | 'template' | 'module' | 'environment' | 'deployment' | 'organization' | 'project' | 'template' | 'module' | 'environment' | 'deployment'
  - `creationScopeId` string, required
  - `creationScope` 'organization' | 'project', required
  - `organizationId` string, required
  - `createdBy` string, required
  - `createdByUser` User
    - `email` string
    - `user_id` string
    - `created_at` string
    - `updated_at` string
    - `app_metadata` AppMetadata
      - `organizations` UserOrganization[]
        - `id` string, required
        - `role` string
        - `name` string
      - `isApiKey` boolean
      - `isAutogeneratedTerraformDeployer` boolean
      - `apiKeyType` 'oidc'
      - `createdBy` string
      - `organizationId` string
      - `isSystemUser` boolean
      - `readOnly` boolean
    - `picture` string
    - `name` string
    - `last_login` string
    - `given_name` string
    - `family_name` string
    - `blocked` boolean
  - `toDelete` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[API](https://skmtc.net/envzero/apis/env0-api.md) · [All operations](https://skmtc.net/envzero/apis/env0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envzero/env0-api/versions/513441cbe9dc/schema)