Skip to main content
PATCH
Update environment

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Path Parameters

id
string
required

Environment UUID.

Body

application/json

Request body for updating an environment. Only provided fields are changed.

name
string
description
string | null
repository_ids
string<uuid>[]

Replaces the repositories this environment clones, in checkout order. An empty array removes all. Requires write access to the environment.

system_prompt
string | null
default_skills
object

Sets default skills on this environment. Switches you omit keep their inherited value, and only switches that differ from the inherited value are stored.

personal_preferences
string | null

Only settable on personal environments. Appended after the (inherited) system prompt.

Response

Environment updated

environment
object
required

The configuration a workspace starts with. An environment builds on its source_environment_id chain, starting at its root. Personal environments have user_id set and are visible only to their owner.