Skip to content
API ReferenceDoc

Environments API

Manage environments (base URLs, model selection) and environment variables.

Environments define where sessions run and what context is available (base URL, variables, model selection, version). API projects require baseUrl. Web projects use it for browser runs, and it is optional; mobile projects can also provide Appium/mobile runtime overrides for a specific device or app target.

List environments (overview)

GET/api/projects/{projectId}/environments/overviewBearer Token

List environments (paged)

GET/api/projects/{projectId}/environmentsBearer Token

Query uses page and pageSize.

Create environment

POST/api/projects/{projectId}/environmentsBearer Token

Update environment

PUT/api/projects/{projectId}/environments/{id}Bearer Token

This is how you update fields like baseUrl, anthropicModel, and version. baseUrl becomes the agent container's TARGET_BASE_URL.

An app project's environment has no baseUrl. Give it its own device or build with APPIUM_* environment variables, such as APPIUM_DEVICE_NAME or APPIUM_APP: see Mobile Runtime.

Delete environment

DELETE/api/projects/{projectId}/environments/{id}Bearer Token

Variables

GET/api/projects/{projectId}/environments/{id}/variablesBearer Token
POST/api/projects/{projectId}/environments/{id}/variablesBearer Token
PUT/api/projects/{projectId}/environments/{envId}/variables/{varId}Bearer Token
DELETE/api/projects/{projectId}/environments/{envId}/variables/{varId}Bearer Token

Project variables

Variables every environment of the project gets. An environment's own variable with the same name wins.

GET/api/projects/{projectId}/variablesBearer Token
POST/api/projects/{projectId}/variablesBearer Token
PUT/api/projects/{projectId}/variables/{varId}Bearer Token
DELETE/api/projects/{projectId}/variables/{varId}Bearer Token