Environments

get

Describe Environment with associated cloud accounts

🔒 Requires the read:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Responses
200

Information about the environment

application/json
get
/api/v1/environment/{idOrSlug}
delete

Delete an environment from the organization

🔒 Requires the delete:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Responses
200

Updated information about the environment

application/json
delete
/api/v1/environment/{idOrSlug}
post

Create an environment for deploying blueprints

🔒 Requires the create:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
namestringRequired

The environment name e.g. Production Europe

Example: Production Europe
colorstringOptional

The environment color code e.g. #0000ff

Example: #0000ffPattern: ^#(?:[0-9a-fA-F]{3}){1,2}$
defaultbooleanOptional

Whether the environment is the default for the organization e.g. true

Responses
200

Information about created environment

application/json
post
/api/v1/environment
put

Enable an environment

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
or
Responses
200

Updated information about the environment

application/json
put
/api/v1/environment
delete

Disable an environment

🔒 Requires the delete:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
or
Responses
200

Updated information about the environment

application/json
delete
/api/v1/environment
put

Change default environment for the organization

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Responses
200

Updated information about the environment

application/json
put
/api/v1/environment/{idOrSlug}/default
patch

Update environment properties such as color code, name, pre-release status, or associated users. Note: The slug remains unchanged even if the name is updated.

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Body
namestringOptional

The environment name e.g. Production Europe

Example: Production Europe
colorstringOptional

The environment color code e.g. #0000ff

Example: #0000ffPattern: ^#(?:[0-9a-fA-F]{3}){1,2}$
allow_pre_releasebooleanOptional

Whether the environment allows pre-release deployments e.g. false

Example: false
cost_quotanumber · min: 1Optional

Maximum allowed total cost for all deployments in this environment in USD e.g. 1000.50

Example: 1000.5
Responses
200

Updated information about the environment

application/json
patch
/api/v1/environment/{idOrSlug}/edit
put

Clone an existing environment with properties and policies

🔒 Requires the create:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Body
namestringRequired

The environment name e.g. Production Europe

Example: Production Europe
Responses
200

Information about cloned environment

application/json
put
/api/v1/environment/{idOrSlug}/clone
get

List environment properties

🔒 Requires the read:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Responses
200

List of environment properties

application/json
get
/api/v1/environment/{idOrSlug}/props
post

Create environment props

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodyobject[]

List of new environment properties

namestringRequired

The property name e.g. max_size

Example: max_size
contentstringRequired

The property value or content e.g. 10

Example: 10
is_enforcedbooleanOptional

Indicates whether the environment property takes precedence over any provided value e.g. true

Default: falseExample: true
Responses
200

Updated environment properties

application/json
post
/api/v1/environment/{idOrSlug}/props
put

Update environment props

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodyobject[]

List of updated environment properties

idstring · uuidOptional

The property ID e.g. 123e4567-e89b-12d3-a456-426614174000

namestringRequired

The property name e.g. max_size

Example: max_size
contentstringRequired

The property value or content e.g. 10

Example: 10
is_enforcedbooleanOptional

Indicates whether the environment property takes precedence over any provided value e.g. true

Default: falseExample: true
Responses
200

Updated environment properties

application/json
put
/api/v1/environment/{idOrSlug}/props
delete

Delete environment props

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodystring[]
string[]Optional
Responses
200

Updated environment props

application/json
delete
/api/v1/environment/{idOrSlug}/props
get

List packages allowed to be deployed in the environment

🔒 Requires the read:package permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Query parameters
offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10
limitnumber · max: 1000Optional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10
searchstringOptional

Enables searching within the list for package names that match a particular query e.g. sns

Responses
200

List of packages allowed in the environment

application/json
get
/api/v1/environment/{idOrSlug}/blueprints
get

List environment secrets

🔒 Requires the read:secret permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Responses
200

List of environment secrets

application/json
get
/api/v1/environment/{idOrSlug}/settings/secrets
post

Create environment secrets

🔒 Requires the create:secret permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodyobject[]

List of new environment-scoped secrets

keystringRequired

The secret key e.g. API_TOKEN

Example: API_TOKEN
valuestringRequired

The secret encrypted value e.g. ERJZ7ZOJcNpQEAvrb6wPOA==

Example: ERJZ7ZOJcNpQEAvrb6wPOA==
Responses
200

Updated environment secrets

application/json
post
/api/v1/environment/{idOrSlug}/settings/secrets
put

Update environment secrets

🔒 Requires the update:secret permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodyobject[]

List of updated environment-scoped secrets

idstring · uuidOptional

The secret ID e.g. 123e4567-e89b-12d3-a456-426614174000

keystringRequired

The secret key e.g. API_TOKEN

Example: API_TOKEN
valuestringRequired

The secret encrypted value e.g. ERJZ7ZOJcNpQEAvrb6wPOA==

Example: ERJZ7ZOJcNpQEAvrb6wPOA==
Responses
200

Updated environment secrets

application/json
put
/api/v1/environment/{idOrSlug}/settings/secrets
delete

Delete environment secrets

🔒 Requires the delete:secret permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodystring[]
string[]Optional

List of secret keys to delete within the environment

Responses
200

Updated environment secrets

application/json
delete
/api/v1/environment/{idOrSlug}/settings/secrets
get

List available environment secrets for the user's organization

🔒 Requires the read:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
sortstring · enumOptional

Specifies the attribute by which the returned list should be sorted ' + 'e.g. name

Default: created_atPossible values:
orderstringOptional

Specifies the order - ascending or descending - by which the returned list should be sorted e.g. ASC

offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10
limitnumberOptional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10
filterstringOptional

Structure: [key1=value1,key2=value2&value3]

searchstringOptional

Enables searching within the list for Secret Keys that match a particular query e.g. api_key

Responses
200

List of available environment secrets

application/json
get
/api/v1/environment/settings/secrets
put

Update environment policies

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
idOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
Bodyobject[]

List of environment policies to update

policystring · enumRequired

The name of the policy

Example: require_owner_approvalPossible values:
enablebooleanRequired

Whether to enable or disable the policy

Responses
200

Updated policy information

application/json
put
/api/v1/environment/{idOrSlug}/settings/policies
get

List available environments for the user's organization

🔒 Requires the read:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
allbooleanOptional

If false, return active environments only. If true, return all environments

offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10
orderstringOptional

Specifies the order - ascending or descending - by which the returned list should be sorted e.g. ASC

filterstringOptional

Structure: [key1=value1,key2=value2&value3]

limitnumberOptional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10
sortstring · enumOptional

Specifies the attribute by which the returned list should be sorted ' + 'e.g. name

Default: createdPossible values:
searchstringOptional

Enables searching within the list for environment names that match a particular query e.g. prod

Responses
200

List of available deployment environments

application/json
get
/api/v1/environments
get

List available Environment properties of an organization

🔒 Requires the read:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10
orderstringOptional

Specifies the order - ascending or descending - by which the returned list should be sorted e.g. ASC

filterstringOptional

Structure: [key1=value1,key2=value2&value3]

limitnumberOptional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10
sortstring · enumOptional

Specifies the attribute by which the returned list should be sorted ' + 'e.g. name

Default: created_atPossible values:
searchstringOptional

Enables searching within the list for environment names that match a particular query

packagestringOptional

The package name with version e.g. @bluebricks/[email protected]

Example: @bluebricks/[email protected]
Responses
200

List of available Environment properties of an organization

application/json
get
/api/v1/environments/props
post

Assign a cloud account to an environment

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
envIdOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
cloudIdstring · uuidRequired

The cloud ID to associate with the environment e.g. 86a6e0b9-65e4-49cc-8d40-ce5dcfbf4eb6

Example: f27d96be-c486-4075-a926-0ee96775119f
Body
is_primarybooleanOptional

Indicate if the cloud is going to be the one used for provisioning in the associated environment

Default: false
profilestringOptional

Profile is a named configuration of a specific cloud account

Example: secrets-manager
Responses
200

Updated environment

application/json
post
/api/v1/environments/{envIdOrSlug}/cloud/{cloudId}
post

Assign a secondary cloud account to an environment

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
envIdOrSlugstringRequired

The environment's slug or ID e.g. prod | f27d96be-c486-4075-a926-0ee96775119d

Example: production-europe
cloudIdstring · uuidRequired

The cloud ID to associate with the environment e.g. 86a6e0b9-65e4-49cc-8d40-ce5dcfbf4eb6

Example: f27d96be-c486-4075-a926-0ee96775119f
Body
profilestringRequired

Profile is a named configuration of a specific cloud account

Example: secrets-manager
Responses
200

Updated environment

application/json
post
/api/v1/environments/{envIdOrSlug}/cloud/secondary/{cloudId}
delete

Dissociate cloud id from environment

🔒 Requires the update:environment permission

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
envIdstring · uuidRequired

The environment's ID e.g. f27d96be-c486-4075-a926-0ee96775119e

Example: f27d96be-c486-4075-a926-0ee96775119e
cloudIdstring · uuidRequired
Responses
200

Updated environment

application/json
delete
/api/v1/environments/{envId}/cloud/{cloudId}

Last updated

Was this helpful?