Environments

Update environment

Updates only the fields you send. Set repository_ids to [] to remove all repositories. personal_preferences can only be set on personal environments and is appended after the inherited system prompt.

patch/v1/environments/{id}

Request

  • Base URL
    https://api.replicas.dev
  • URL
    https://api.replicas.dev/v1/environments/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Environment UUID.

Headers

X-Replicas-Api-Version'2026-10-07'

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

Request body

namestring
descriptionstring nullable
repository_idsstring[]

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

system_promptstring nullable
personal_preferencesstring nullable

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

Response

Environment updated

Changes

No recorded changes to this operation across all 1 revision of this API.