v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Environments

Clones an environment

Enterprise feature

Given an existing environment name and a set of options, this will create a copy of that environment

post/api/admin/environments/{name}/clone

Path parameters

namestring required

Request body

namestring required

The name of the new cloned environment, this cannot be changed later

typestring required

Updates the type of environment (i.e. development or production).

projectsstring[]

A list of projects that should be included in the cloned environment.

clonePermissionsboolean

Copies the RBAC permissions from the source environment if true. Defaults to true

Example request

{
  "name": "development",
  "type": "development"
}

Response

environmentSchema

namestring required

The name of the environment

typestring required

The type of environment.

enabledboolean required

true if the environment is enabled for the project, otherwise false.

protectedboolean required

true if the environment is protected, otherwise false. A protected environment can not be deleted.

sortOrderinteger required

Priority of the environment in a list of environments, the lower the value, the higher up in the list the environment will appear. Needs to be an integer

projectCountinteger nullable

The number of projects with this environment

apiTokenCountinteger nullable

The number of API tokens for the project environment

enabledToggleCountinteger nullable

The number of enabled toggles for the project environment

requiredApprovalsinteger nullable

Experimental field. The number of approvals required before a change request can be applied in this environment.

Example response

{
  "name": "my-dev-env",
  "type": "development",
  "enabled": true,
  "protected": true,
  "sortOrder": 3,
  "projectCount": 10,
  "apiTokenCount": 6,
  "enabledToggleCount": 10,
  "requiredApprovals": 3
}