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)
/api/projects/{projectId}/environments/overviewBearer TokenList environments (paged)
/api/projects/{projectId}/environmentsBearer TokenQuery uses page and pageSize.
Create environment
/api/projects/{projectId}/environmentsBearer TokenUpdate environment
/api/projects/{projectId}/environments/{id}Bearer TokenThis 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
/api/projects/{projectId}/environments/{id}Bearer TokenVariables
/api/projects/{projectId}/environments/{id}/variablesBearer Token/api/projects/{projectId}/environments/{id}/variablesBearer Token/api/projects/{projectId}/environments/{envId}/variables/{varId}Bearer Token/api/projects/{projectId}/environments/{envId}/variables/{varId}Bearer TokenProject variables
Variables every environment of the project gets. An environment's own variable with the same name wins.
/api/projects/{projectId}/variablesBearer Token/api/projects/{projectId}/variablesBearer Token/api/projects/{projectId}/variables/{varId}Bearer Token/api/projects/{projectId}/variables/{varId}Bearer Token