Skip to main content
The Scrums.com API is planned and not yet publicly available. Endpoints and behaviour are subject to change before release.
Environments represent named deployment and configuration contexts within a project. Each environment holds its own variables, resources, and deployment state. Standard environment types include development, staging, and production, with support for custom named environments.

Base path

/v1/projects/{project_id}/environments

Endpoints

MethodPathDescription
GET/v1/projects/{project_id}/environmentsList environments for a project
POST/v1/projects/{project_id}/environmentsCreate an environment
GET/v1/environments/{id}Get an environment
PATCH/v1/environments/{id}Update an environment
DELETE/v1/environments/{id}Delete an environment
GET/v1/environments/{id}/variablesList environment variables
PUT/v1/environments/{id}/variablesSet environment variables

Attributes

FieldTypeDescription
idstringUnique identifier
project_idstringParent project reference
namestringDisplay name
slugstringURL-safe identifier (e.g. production)
typeenumdevelopment, staging, production, custom
protectedbooleanRestricts direct deployments if true
created_atdatetimeISO 8601 timestamp
updated_atdatetimeISO 8601 timestamp

Relationships

Environments belong to Projects and are associated with Resources and Usage Records.
Last modified on April 15, 2026