Get all environments

GET 
/api/admin/environments

Retrieves all environments that exist in this Unleash instance.

Responses

200

environmentsSchema

application/json

Schema

Schema

version integerrequired
Version of the environments schema
Example: 1

environments

object[]

required

List of environments

Array [

name stringrequired

The name of the environment

Example: my-dev-env

type stringrequired

The type of environment.

Example: development

enabled booleanrequired

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

Example: true

protected booleanrequired

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

Example: true

sortOrder integerrequired

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

Example: 3

projectCount integernullable

The number of projects with this environment

Example: 10

apiTokenCount integernullable

The number of API tokens for the project environment

Example: 6

enabledToggleCount integernullable

The number of enabled toggles for the project environment

Example: 10

]

Example (from schema)

{
  "version": 1,
  "environments": [
    {
      "name": "my-dev-env",
      "type": "development",
      "enabled": true,
      "protected": true,
      "sortOrder": 3,
      "projectCount": 10,
      "apiTokenCount": 6,
      "enabledToggleCount": 10
    }
  ]
}

401

Authorization information is missing or invalid. Provide a valid API token as the authorization header, e.g. authorization:*.*.my-admin-token.

application/json

Schema

Schema

id string
The ID of the error instance
Example: 9c40958a-daac-400e-98fb-3bb438567008
name string
The name of the error kind
Example: AuthenticationRequired
message string
A description of what went wrong.
Example: You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login.

Example (from schema)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "AuthenticationRequired",
  "message": "You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login."
}

403

The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation

application/json

Schema

Schema

id string
The ID of the error instance
Example: 9c40958a-daac-400e-98fb-3bb438567008
name string
The name of the error kind
Example: NoAccessError
message string
A description of what went wrong.
Example: You need the "UPDATE_ADDON" permission to perform this action in the "development" environment.

Example (from schema)

{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "NoAccessError",
  "message": "You need the \"UPDATE_ADDON\" permission to perform this action in the \"development\" environment."
}

Loading...