Environments

Create environment

Creates an organization (scope: "org") or personal (scope: "user") environment. Set source_environment_id to create a live fork, as in Fork environment. Pass repository_ids to choose the repositories to clone.

post/v1/environments

Request

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

Headers

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

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

Request body

namestring required

Human-readable name (must be unique within the selected scope)

descriptionstring nullable

Optional description

scope'org' | 'user'

org creates a team environment. user creates a personal environment visible only to the authenticated user.

source_environment_idstring uuid nullable

Optional parent. Creates a live fork, as in Fork environment; the repository binding, system prompt, and memory settings in the body are ignored.

repository_idsstring[]

Repositories to clone, in checkout order.

system_promptstring nullable

Optional system prompt prepended to the coding agent.

Response

Environment created

Changes

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