Clones an environment | Unleash Documentation

Enterprise feature

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

Enterprise feature

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

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Path parameters

namestringRequired

Request

cloneEnvironmentSchema

namestringRequired

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

typestringRequired

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

projectslist of stringsOptional

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

clonePermissionsbooleanOptional

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

Response

environmentSchema

namestring

The name of the environment

typestring

The type of environment.

enabledboolean

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

protectedboolean

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

sortOrderinteger

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 or null>=0

The number of projects with this environment

apiTokenCountinteger or null>=0

The number of API tokens for the project environment

enabledToggleCountinteger or null>=0

The number of enabled toggles for the project environment

requiredApprovalsinteger or null>=1

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

Errors

400

Bad Request Error

401

Unauthorized Error

API key needed to access this API

API key needed to access this API, in Bearer token format

cloneEnvironmentSchema

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

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

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

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

The name of the environment

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

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

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

The number of projects with this environment

The number of API tokens for the project environment

The number of enabled toggles for the project environment

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

$	curl -X POST https://app.unleash-instance.example.com/api/admin/environments/name/clone \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "development",
>	"type": "development"
>	}'

1	{
2	"name": "my-dev-env",
3	"type": "development",
4	"enabled": true,
5	"protected": true,
6	"sortOrder": 3,
7	"projectCount": 10,
8	"apiTokenCount": 6,
9	"enabledToggleCount": 10,
10	"requiredApprovals": 3
11	}

$	curl -X POST https://app.unleash-instance.example.com/api/admin/environments/name/clone \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "development",
>	"type": "development"
>	}'

1	{
2	"name": "my-dev-env",
3	"type": "development",
4	"enabled": true,
5	"protected": true,
6	"sortOrder": 3,
7	"projectCount": 10,
8	"apiTokenCount": 6,
9	"enabledToggleCount": 10,
10	"requiredApprovals": 3
11	}