Get all environments
GEThttps://us.app.unleash-hosted.com/ushosted/api/admin/environments
Retrieves all environments that exist in this Unleash instance.
Responses
- 200
- 401
- 403
environmentsSchema
- application/json
- Schema
- Example (from schema)
Schema
version integerrequired
Version of the environments schema
Example:
1
environments
object[]
required
{
"version": 1,
"environments": [
{
"name": "my-dev-env",
"type": "development",
"enabled": true,
"protected": true,
"sortOrder": 3,
"projectCount": 10,
"apiTokenCount": 6,
"enabledToggleCount": 10
}
]
}
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 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.
{
"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 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.
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "NoAccessError",
"message": "You need the \"UPDATE_ADDON\" permission to perform this action in the \"development\" environment."
}
Authorization: Authorization
name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L 'https://us.app.unleash-hosted.com/ushosted/api/admin/environments' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
ResponseClear