Skip to main content
PATCH
/
v1
/
environments
/
{id}
Update Environment
curl --request PATCH \
  --url https://api.tryreplicas.com/v1/environments/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "system_prompt": "<string>"
}
'
{
  "environment": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "is_global": true,
    "repository_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "repository_set_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "system_prompt": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "variable_count": 123,
    "file_count": 123,
    "skill_count": 123,
    "mcp_count": 123
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Obtain your API key from the Replicas dashboard under Settings > API Keys.

Path Parameters

​
id
string
required

Environment UUID. The literal global is rejected with 400 — see endpoint description.

Body

application/json

Request body for updating an environment. Only provided fields are changed. repository_id and repository_set_id remain mutually exclusive when both are supplied.

​
name
string
​
description
string | null
​
repository_id
string<uuid> | null
​
repository_set_id
string<uuid> | null
​
system_prompt
string | null

Response

Environment updated

​
environment
object
required

An environment — the config bundle workspaces are created from. Holds an optional repository binding plus the runtime variables, files, skills, MCPs, and warm hook applied to every workspace built from it. Every organization has a singleton Global environment (is_global: true) whose values are layered onto every other environment.