# Replicas Docs

## Docs

- [Audit Log](https://docs.replicas.dev/admin/audit-log.md): Track configuration changes across your organization.
- [Billing](https://docs.replicas.dev/admin/billing.md): Understand how Replicas billing works across plans, seats, and API usage.
- [Credentials](https://docs.replicas.dev/admin/credentials.md): Configure coding agents and integrations.
- [Team](https://docs.replicas.dev/admin/team.md): Invite members and manage roles.
- [Create Automation](https://docs.replicas.dev/api-reference/automation/create-automation.md): Creates a new automation in your organization. The automation is bound to a single environment, which determines the repository (or repository set) and resolved env vars / MCPs / skills used when the automation fires.
- [Delete Automation](https://docs.replicas.dev/api-reference/automation/delete-automation.md): Deletes an automation by its ID. This also deletes all associated execution history.
- [Fire a Custom Webhook Automation](https://docs.replicas.dev/api-reference/automation/fire-a-custom-webhook-automation.md): Fires an automation that has a `custom` webhook trigger. The token in the URL is the secret: any caller that knows the URL can fire the automation, so this endpoint is unauthenticated by design (no API key). The request body is parsed as JSON and embedded into the automation's prompt under `## Trigg…
- [Get Automation](https://docs.replicas.dev/api-reference/automation/get-automation.md): Returns detailed information about a specific automation.
- [List Automation Executions](https://docs.replicas.dev/api-reference/automation/list-automation-executions.md): Returns a paginated list of execution history for an automation.
- [List Automations](https://docs.replicas.dev/api-reference/automation/list-automations.md): Returns a paginated list of automations for your organization.
- [Trigger Automation](https://docs.replicas.dev/api-reference/automation/trigger-automation.md): Manually triggers an automation. Only automations with a cron trigger can be manually triggered. This creates a new workspace and execution.
- [Update Automation](https://docs.replicas.dev/api-reference/automation/update-automation.md): Updates an existing automation. Only the fields provided in the request body will be updated.
- [Create Environment](https://docs.replicas.dev/api-reference/environments/create-environment.md): Creates a new environment. `repository_id` and `repository_set_id` are mutually exclusive; both may be omitted for an unbound environment that cannot back a workspace yet.
- [Create Environment File](https://docs.replicas.dev/api-reference/environments/create-environment-file.md): Adds a new file to the environment. Maximum content size is 64 KB (65,536 bytes). The `path` is validated against allowed locations (typically under `~/`).
- [Create Environment MCP](https://docs.replicas.dev/api-reference/environments/create-environment-mcp.md): Adds a new MCP server to the environment. `name` must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$` and cannot start with reserved prefixes `relay-` or `replicas-`. The `config` shape depends on the `transport`: stdio uses `{ command, args, env }`; http and sse use `{ url, headers }`.
- [Create Environment Variable](https://docs.replicas.dev/api-reference/environments/create-environment-variable.md): Adds a new variable to the environment. Values are encrypted at rest. The `(environment, key)` pair must be unique within the org.
- [Delete Environment](https://docs.replicas.dev/api-reference/environments/delete-environment.md): Deletes an environment. Returns 409 when an automation still references the environment, or when called against the Global environment (which cannot be deleted).
- [Delete Environment File](https://docs.replicas.dev/api-reference/environments/delete-environment-file.md)
- [Delete Environment MCP](https://docs.replicas.dev/api-reference/environments/delete-environment-mcp.md)
- [Delete Environment Variable](https://docs.replicas.dev/api-reference/environments/delete-environment-variable.md)
- [Disable Environment Skill](https://docs.replicas.dev/api-reference/environments/disable-environment-skill.md): Disables a previously enabled skill on the environment.
- [Enable Environment Skill](https://docs.replicas.dev/api-reference/environments/enable-environment-skill.md): Enables a skill on the environment. Use [GET /v1/environment-skills/search](#tag/Environments/operation/searchEnvironmentSkills) to discover skills first, then enable them with this endpoint. Returns 409 if the skill (by `slug` or `source`) is already enabled on the environment.
- [Enable or Disable Warm Pool](https://docs.replicas.dev/api-reference/environments/enable-or-disable-warm-pool.md): Enables or disables the warm pool for the environment. The target pool size is fixed by the platform; only `enabled` is configurable from the API.
- [Get Environment](https://docs.replicas.dev/api-reference/environments/get-environment.md): Returns a single environment. Pass the literal string `global` for the org's singleton Global environment (auto-created on first access — no need to look up its UUID first).
- [Get Warm Hooks State](https://docs.replicas.dev/api-reference/environments/get-warm-hooks-state.md): Returns the active warm hook (if any) and warm pool config (if any) for the environment, along with current pool counts.
- [List Environment Files](https://docs.replicas.dev/api-reference/environments/list-environment-files.md): Returns every file attached to the environment. Files are dropped into the workspace at the configured `path` when the workspace is provisioned.
- [List Environment MCPs](https://docs.replicas.dev/api-reference/environments/list-environment-mcps.md): Returns every MCP (Model Context Protocol server) attached to the environment.
- [List Environment Skills](https://docs.replicas.dev/api-reference/environments/list-environment-skills.md): Returns every skill enabled on the environment. Skills come from [skills.sh](https://skills.sh) and are installed into workspaces created from the environment.
- [List Environment Variables](https://docs.replicas.dev/api-reference/environments/list-environment-variables.md): Returns every variable attached to the environment. Values are returned in plaintext (they are encrypted at rest, decrypted on read).
- [List Environments](https://docs.replicas.dev/api-reference/environments/list-environments.md): Returns every environment in your organization, including the singleton Global environment. Each record includes counts of attached variables, files, skills, and MCPs.
- [List Warm Pool Workspaces](https://docs.replicas.dev/api-reference/environments/list-warm-pool-workspaces.md): Returns the most recent pre-warmed workspaces for a warm pool config, including their status (warming, ready, stale, assigned, expired, failed). Useful for inspecting why a pool is not delivering ready workspaces. Returns up to 10 entries.
- [Save and Test Warm Hook](https://docs.replicas.dev/api-reference/environments/save-and-test-warm-hook.md): Saves the supplied script as the active warm hook for the environment and runs it in an isolated sandbox. Always persists the new version; the response includes the test result so callers can decide whether to roll back. The endpoint takes 30–90 seconds to return because it spins up a real sandbox.
- [Search Skill Catalog](https://docs.replicas.dev/api-reference/environments/search-skill-catalog.md): Searches the [skills.sh](https://skills.sh) catalog for skills that can be enabled on an environment via [POST /v1/environments/{environmentId}/skills](#tag/Environments/operation/createEnvironmentSkill).
- [Test Warm Hook](https://docs.replicas.dev/api-reference/environments/test-warm-hook.md): Runs the supplied script in an isolated sandbox without persisting it. Useful for iterating on a warm hook from the API before committing it via `save-test`. Takes 30–90 seconds to return.
- [Update Environment](https://docs.replicas.dev/api-reference/environments/update-environment.md): Updates a non-global environment. Only provided fields are changed. `PATCH /v1/environments/global` returns 400 with a pointer to the nested resource endpoints (variables, files, skills, MCPs, warm hooks) — the Global env's metadata cannot be edited directly. Returns 409 when an automation still ref…
- [Update Environment File](https://docs.replicas.dev/api-reference/environments/update-environment-file.md)
- [Update Environment MCP](https://docs.replicas.dev/api-reference/environments/update-environment-mcp.md): Updates an MCP. Only provided fields are changed. When changing `transport`, `config` is required and must match the new transport's shape.
- [Update Environment Variable](https://docs.replicas.dev/api-reference/environments/update-environment-variable.md): Updates a variable. Only provided fields are changed.
- [Create Chat](https://docs.replicas.dev/api-reference/replica/create-chat.md): Creates a new chat session for a replica.
- [Create Replica](https://docs.replicas.dev/api-reference/replica/create-replica.md): Creates a new replica in your organization and sends an initial message to the coding agent. The workspace and agent are initialized asynchronously.
- [Delete Chat](https://docs.replicas.dev/api-reference/replica/delete-chat.md): Deletes a chat session from a replica.
- [Delete Replica](https://docs.replicas.dev/api-reference/replica/delete-replica.md): Deletes a replica by its ID. This terminates the underlying sandbox and processes any outstanding billing.
- [Get Hook Logs](https://docs.replicas.dev/api-reference/replica/get-hook-logs.md): Returns the warm hook and start hook execution logs for a replica.
- [Get Replica](https://docs.replicas.dev/api-reference/replica/get-replica.md): Returns detailed information about a specific replica by its ID. Use the `include` query parameter to request additional data such as environment configuration and diffs. If the workspace is sleeping, it will be woken and the response will indicate this with `waking: true`.
- [List Chats](https://docs.replicas.dev/api-reference/replica/list-chats.md): Returns a list of chats for a replica.
- [List Replicas](https://docs.replicas.dev/api-reference/replica/list-replicas.md): Returns a paginated list of all replicas in your organization. Supports filtering by user, source, and status.
- [Read History](https://docs.replicas.dev/api-reference/replica/read-history.md): Reads the conversation history for a replica with pagination from the end (bottom-up). Optionally filter by chat ID. If the workspace is sleeping, it will be woken and the response will indicate this with `waking: true`. Retry in 30-90 seconds when waking.
- [Send Message](https://docs.replicas.dev/api-reference/replica/send-message.md): Sends a message to an existing replica. Supports targeting a specific chat, choosing a coding agent and model, attaching images, and enabling plan mode.
- [Stream Events](https://docs.replicas.dev/api-reference/replica/stream-events.md): Opens a Server-Sent Events (SSE) stream for real-time events from a replica. The connection remains open and events are pushed as they occur.
- [List Repositories](https://docs.replicas.dev/api-reference/repository/list-repositories.md): Returns a list of repositories available to your organization.
- [List Repository Sets](https://docs.replicas.dev/api-reference/repository/list-repository-sets.md): Returns a list of repository sets available to your organization.
- [Changelog](https://docs.replicas.dev/changelog.md): Product updates and announcements
- [Replica API](https://docs.replicas.dev/features/api.md): Programmatically create and manage replicas.
- [Automations](https://docs.replicas.dev/features/automations.md): Run agents on a schedule or in response to GitHub, Slack, Sentry, or custom webhook events.
- [CLI](https://docs.replicas.dev/features/cli.md): Connect to workspaces from your terminal.
- [Doppler](https://docs.replicas.dev/features/doppler.md): Sync environment variables from Doppler into workspaces.
- [Environments](https://docs.replicas.dev/features/environments.md): Configure variables, files, skills, MCPs, and warm hooks for your workspaces.
- [GitHub](https://docs.replicas.dev/features/github.md): Trigger tasks from GitHub issues and iterate on pull requests with Replicas.
- [Infisical](https://docs.replicas.dev/features/infisical.md): Sync environment variables from Infisical into workspaces.
- [Linear](https://docs.replicas.dev/features/linear.md): Assign tasks to Replicas directly from Linear.
- [MCP](https://docs.replicas.dev/features/mcp.md): Use Replicas from Claude Desktop, Poke, and other MCP clients.
- [Sentry](https://docs.replicas.dev/features/sentry.md): Fire automations from Sentry issue alerts and new errors.
- [Slack](https://docs.replicas.dev/features/slack.md): Trigger tasks by mentioning @Replicas in Slack channels.
- [Overview](https://docs.replicas.dev/features/workspaces/overview.md): How workspaces run and manage themselves.
- [Plan Mode](https://docs.replicas.dev/features/workspaces/plan-mode.md): Ask agents to propose a plan before they change code.
- [Repository Config](https://docs.replicas.dev/features/workspaces/repository-configuration.md): Configure environment setup on workspaces.
- [Welcome](https://docs.replicas.dev/index.md)
- [Quickstart](https://docs.replicas.dev/quickstart.md): Set up Replicas and create your first workspace in 5 minutes.

## OpenAPI Specs

- [openapi](https://docs.replicas.dev/openapi.json)