Skip to main content
The Replicas API lets you programmatically trigger background agents for your own apps and workflows.

​
Authentication

Generate an API key from Settings > API Keys in the dashboard. Include it as a Bearer token in requests: 
curl -X GET "https://api.replicas.dev/v1/replica" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Quick Start

​
Create a Replica

curl -X POST "https://api.replicas.dev/v1/replica" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "fix-auth-bug",
    "repository": "acme/my-app",
    "message": "Fix the login timeout issue in src/auth.ts"
  }'
The replica boots asynchronously and the message is delivered once ready.

​
Send a Follow-up Message

curl -X POST "https://api.replicas.dev/v1/replica/{id}/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Also add tests for the fix"
  }'
If the replica is sleeping, it wakes automatically. Messages queue if the agent is busy.

​
Prerequisites

Before using the API:
  1. Add your repository in the dashboard
  2. Configure credentials for your coding agent (Claude or Codex)
  3. Ensure your organization has an SSH key configured

​
Use Cases

  • CI/CD Integration - Trigger replicas from GitHub Actions or other pipelines
  • Batch Operations - Create multiple replicas for parallel task execution
  • Custom Workflows - Build internal tools that leverage AI coding agents

​
API Reference

See the API Reference tab for complete endpoint documentation with request/response schemas.