List environments
Lists active and archived environments for a visible project.
GEThttps://api.featuregate.dev/v1/projects/{projectId}/environments
Authenticate with a management automation key in the Authorization header.management:environments:read
Path parameters
projectIdstringrequired
Stable project_ identifier.
Pattern: ^project_.+
Request
sh
curl -X GET https://api.featuregate.dev/v1/projects/project_example/environments \
-H "Authorization: Bearer fg_ak_test_0123456789abcdef0123456789abcdef0123456789abcdef"Returns
environmentsobject[]required
idstringrequired
Stable environment identifier, prefixed with env_.
Length: 1+
createdAtstringrequired
Environment creation timestamp.
updatedAtstringrequired
Last environment update timestamp.
archivedAtstring | nullrequired
Archive timestamp, or null while active.
projectIdstringrequired
Owning project identifier.
Length: 1+
keystringrequired
Developer-facing environment key.
Length: 1+
kind"local" | "development" | "test" | "qa" | "staging" | "preview" | "production" | "other"required
Environment classification used for console badges and production safeguards.
Options: local, development, test, qa, staging, preview, production, other
namestringrequired
Human-readable environment name.
Length: 1+
shortLabelstringrequired
Compact badge label used in the console.
Length: 1+
sortOrderintegerrequired
Display order within the project.
Example response · 200
json
{
"environments": []
}Responses
200Project environments ordered for display and automation.
400Validation failed.
401Authentication failed.
403The key is not allowed to access this resource.
429Rate limit exceeded.
500Unexpected server error.