Skip to main content
POST
/
v1
/
replica
Create Replica
curl --request POST \
  --url https://api.replicas.dev/v1/replica \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "message": "<string>",
  "repository": "<string>",
  "instance_type": "standard",
  "coding_agent": "claude"
}
'
{
  "replica": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "status": "active",
    "created_at": "2023-11-07T05:31:56Z",
    "instance_type": "standard"
  }
}

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 replica

​
name
string
required

Human-readable name for the replica

​
message
string
required

Initial message to send to the coding agent

​
repository
string
required

Name of the repository (must be added in the dashboard first)

​
instance_type
enum<string>
default:standard

Instance type for the replica

Available options:
standard,
large,
power
​
coding_agent
enum<string>
default:claude

Coding agent to use

Available options:
claude,
codex

Response

Replica created successfully

​
replica
object
required

A replica represents a cloud workspace for AI agents.