Skip to main content
POST
/
v1
/
environments
Create Environment
curl --request POST \
  --url https://api.tryreplicas.com/v1/environments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "scope": "org",
  "source_environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "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",
    "user_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.

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 environment to copy variables, files, skills, skill registries, and MCPs from.

​
repository_id
string<uuid> | null

Bind to this repository. Mutually exclusive with repository_set_id.

​
repository_set_id
string<uuid> | null

Bind to this repository set. Mutually exclusive with repository_id.

​
system_prompt
string | null

Optional system prompt prepended to the coding agent.

Response

Environment created

​
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. Personal environments have user_id set and are visible only to their owner.