Get a list of all projects.
GET/api/admin/projects
This endpoint returns an list of all the projects in the Unleash instance.
Request
Query Parameters
Responses
- 200
- 401
- 403
projectsSchema
- application/json
- Schema
- Example (from schema)
Schema
Array [
- MOD1
- MOD2
Array [
- MOD1
- MOD2
]
Array [
]
]
The schema version used to represent the project data.
1
projects
object[]
required
A list of projects in the Unleash instance
The id of this project
dx-squad
The name of this project
DX-Squad
Additional information about the project
DX squad feature release
The number of features this project has
10
The number of stale features this project has
10
The number of potentially stale features this project has
10
The number of members this project has
4
When this project was created.
2023-07-27T12:12:28Z
When this project was last updated.
2023-07-28T12:12:28Z
When this project was last updated.
2023-07-28T12:12:28Z
When this project was archived.
2023-07-28T12:12:28Z
true
if the project was favorited, otherwise false
.
true
The project's collaboration mode. Determines whether non-project members can submit change requests or not.
Possible values: [open
, protected
, private
]
open
A default stickiness for the project affecting the default stickiness value for variants and Gradual Rollout strategy
userId
The average time from when a feature was created to when it was enabled in the "production" environment during the current window
10
Across all flags in your project this is the last time usage metrics where reported from connected applications.
2023-07-28T12:12:28Z
owners
object
The users and/or groups that have the "owner" role in this project. If no such users or groups exist, the list will contain the "system" owner instead.
oneOf
anyOf
Possible values: [user
]
User Name
https://example.com/image.jpg
user@example.com
Possible values: [group
]
Group Name
Possible values: [system
]
{
"version": 1,
"projects": [
{
"id": "dx-squad",
"name": "DX-Squad",
"health": 50,
"featureCount": 10,
"memberCount": 4,
"createdAt": "2023-07-27T12:12:28Z",
"lastUpdatedAt": "2023-07-28T12:12:28Z",
"archivedAt": "2023-07-28T12:12:28Z",
"favorite": true,
"mode": "open",
"lastReportedFlagUsage": "2023-07-28T12:12:28Z",
"owners": [
null
]
}
]
}
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
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
AuthenticationRequired
A description of what went wrong.
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
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
NoAccessError
A description of what went wrong.
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."
}