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>",
  "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",
    "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 org)

​
description
string | null

Optional description

​
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.