Get the environments available to a project
GET /api/admin/environments/project/:projectId
Gets the environments that are available for this project. An environment is available for a project if enabled in the project configuration
Request
Path Parameters
- projectId string required
- 200
- 401
- 403
- 404
environmentsProjectSchema
- application/json
- Schema
- Example (from schema)
Schema
- version integer requiredVersion of the environments schema 
- environments object[]required- List of environments Array [name string required- The name of the environment type string required- The type of environment. enabled boolean required- trueif the environment is enabled for the project, otherwise- falseprotected boolean required- trueif the environment is protected, otherwise- false. A protected environment can not be deleted.sortOrder integer required- Priority of the environment in a list of environments, the lower the value, the higher up in the list the environment will appear projectApiTokenCount integer- The number of client and front-end API tokens that have access to this project projectEnabledToggleCount integer- The number of features enabled in this environment for this project - defaultStrategy object- The strategy configuration to add when enabling a feature environment by default name string required- The name of the strategy type title string nullable- A descriptive title for the strategy disabled boolean nullable- A toggle to disable the strategy. defaults to false. Disabled strategies are not evaluated or returned to the SDKs sortOrder number- The order of the strategy in the list - constraints object[]- A list of the constraints attached to the strategy. See https://docs.getunleash.io/reference/strategy-constraints Array [contextName string required- The name of the context field that this constraint should apply to. operator string required- Possible values: [ - NOT_IN,- IN,- STR_ENDS_WITH,- STR_STARTS_WITH,- STR_CONTAINS,- NUM_EQ,- NUM_GT,- NUM_GTE,- NUM_LT,- NUM_LTE,- DATE_AFTER,- DATE_BEFORE,- SEMVER_EQ,- SEMVER_GT,- SEMVER_LT]- The operator to use when evaluating this constraint. For more information about the various operators, refer to the strategy constraint operator documentation. caseInsensitive boolean- Default value: - false- Whether the operator should be case sensitive or not. Defaults to - false(being case sensitive).inverted boolean- Default value: - false- Whether the result should be negated or not. If - true, will turn a- trueresult into a- falseresult and vice versa.values string[]- The context values that should be used for constraint evaluation. Use this property instead of - valuefor properties that accept multiple values.value string- The context value that should be used for constraint evaluation. Use this property instead of - valuesfor properties that only accept single values.]- variants object[]- Strategy level variants Array [name string required- The variant name. Must be unique for this feature flag weight integer required- Possible values: - <= 1000- The weight is the likelihood of any one user getting this variant. It is an integer between 0 and 1000. See the section on variant weights for more information weightType string required- Possible values: [ - variable,- fix]- Set to - fixif this variant must have exactly the weight allocated to it. If the type is- variable, the weight will adjust so that the total weight of all variants adds up to 1000. Refer to the variant weight documentation.stickiness string required- The stickiness to use for distribution of this variant. Stickiness is how Unleash guarantees that the same user gets the same variant every time - payload object- Extra data configured for this variant type string required- Possible values: [ - json,- csv,- string,- number]- The type of the value. Commonly used types are string, number, json and csv. value string required- The actual value of payload ]- parameters object- A list of parameters for a strategy property name* stringsegments number[]- Ids of segments to use for this strategy ]
{
  "version": 1,
  "environments": [
    {
      "name": "development",
      "type": "production",
      "enabled": true,
      "protected": false,
      "sortOrder": 1,
      "projectApiTokenCount": 5,
      "projectEnabledToggleCount": 7,
      "defaultStrategy": {
        "name": "flexibleRollout",
        "title": "Gradual Rollout 25-Prod",
        "disabled": false,
        "sortOrder": 9999,
        "constraints": [
          {
            "values": [
              "1",
              "2"
            ],
            "inverted": false,
            "operator": "IN",
            "contextName": "appName",
            "caseInsensitive": false
          }
        ],
        "variants": [
          {
            "name": "blue_group",
            "weight": 0,
            "weightType": "fix",
            "stickiness": "custom.context.field",
            "payload": {
              "type": "json",
              "value": "{\"color\": \"red\"}"
            }
          }
        ],
        "parameters": {
          "groupId": "some_new",
          "rollout": "25",
          "stickiness": "sessionId"
        },
        "segments": [
          1,
          2
        ]
      }
    }
  ]
}
Authorization information is missing or invalid. Provide a valid API token as the authorization header, e.g. authorization:*.*.my-admin-token.
- application/json
- Schema
- Example (from schema)
Schema
- id stringThe ID of the error instance 
- name stringThe name of the error kind 
- message stringA description of what went wrong. 
{
  "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."
}
The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- application/json
- Schema
- Example (from schema)
Schema
- id stringThe ID of the error instance 
- name stringThe name of the error kind 
- message stringA description of what went wrong. 
{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "NoAccessError",
  "message": "You need the \"UPDATE_ADDON\" permission to perform this action in the \"development\" environment."
}
The requested resource was not found.
- application/json
- Schema
- Example (from schema)
Schema
- id stringThe ID of the error instance 
- name stringThe name of the error kind 
- message stringA description of what went wrong. 
{
  "id": "9c40958a-daac-400e-98fb-3bb438567008",
  "name": "NotFoundError",
  "message": "Could not find the addon with ID \"12345\"."
}