Skip to main content
POST
Create 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

Body

application/json

Request body for creating a new environment.

name
string
required

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

description
string | null

Optional description

scope
enum<string>
default:org

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

Available options:
org,
user
source_environment_id
string<uuid> | null

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

repository_ids
string<uuid>[]

Repositories to clone, in checkout order.

system_prompt
string | null

Optional system prompt prepended to the coding agent.

Response

Environment created

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.