# Replicas Docs

- [Welcome](https://docs.replicas.dev/index.md): Set up Replicas, connect your tools, and send coding agents to work.
- [Quickstart](https://docs.replicas.dev/quickstart.md): Set up Replicas and create your first workspace in 5 minutes.
- [Workspaces](https://docs.replicas.dev/features/workspaces/overview.md): Understand workspace setup, tools, collaboration, and lifecycle.
- [Environments](https://docs.replicas.dev/features/environments.md): Configure variables, files, skills, MCPs, plugins, start hooks, and warm hooks for your workspaces.
- [Repository Config](https://docs.replicas.dev/features/workspaces/repository-configuration.md): Configure environment setup on workspaces.
- [Plan mode](https://docs.replicas.dev/features/workspaces/plan-mode.md): Ask agents to propose a plan before they change code.
- [Fast mode](https://docs.replicas.dev/features/workspaces/fast-mode.md): Speed up agent responses with a faster service tier.
- [Motherships](https://docs.replicas.dev/features/workspaces/motherships.md): Long-lived orchestrators that delegate a domain's work to ship workspaces.
- [Canvas](https://docs.replicas.dev/features/workspaces/canvas.md): Files agents drop into the workspace for you to view in the app.
- [Visuals](https://docs.replicas.dev/features/workspaces/visuals.md): Charts, diagrams, comparisons, and mockups agents show inline in their replies.
- [Chat forking](https://docs.replicas.dev/features/workspaces/chat-forking.md): Move a chat to another coding agent harness without losing its context.
- [Workspace Identity](https://docs.replicas.dev/features/workspaces/workspace-identity.md): Let agents authenticate to AWS, Google Cloud, MCP servers, and your own APIs with short-lived tokens instead of stored keys.
- [Static Egress IP](https://docs.replicas.dev/features/static-egress-ip.md): Send a workspace's traffic to chosen destinations through one permanent address that your systems can allowlist.
- [Claude Code](https://docs.replicas.dev/features/coding-agents/claude-code.md): Run Claude Code agents in Replicas workspaces.
- [Codex](https://docs.replicas.dev/features/coding-agents/codex.md): Run OpenAI Codex agents in Replicas workspaces.
- [Cursor](https://docs.replicas.dev/features/coding-agents/cursor.md): Run Cursor Composer agents in Replicas workspaces.
- [Muse Code](https://docs.replicas.dev/features/coding-agents/muse-code.md): Run Muse Code with your Muse subscription or API key in Replicas workspaces.
- [Opencode](https://docs.replicas.dev/features/coding-agents/opencode.md): Run Opencode agents in Replicas workspaces with OpenCode Go, Aster, or OpenRouter.
- [Pi](https://docs.replicas.dev/features/coding-agents/pi.md): Run OpenCode Go-, Aster-, or OpenRouter-backed Pi coding agents in Replicas workspaces.
- [GitHub](https://docs.replicas.dev/features/github.md): Trigger tasks from GitHub issues and iterate on pull requests with Replicas.
- [GitLab](https://docs.replicas.dev/features/gitlab.md): Trigger tasks from GitLab issues and iterate on merge requests with Replicas.
- [Review](https://docs.replicas.dev/features/review.md): Review GitHub pull requests and GitLab merge requests with an agent next to the diff.
- [Linear](https://docs.replicas.dev/features/linear.md): Assign tasks to Replicas directly from Linear.
- [Slack](https://docs.replicas.dev/features/slack.md): Trigger tasks by mentioning @Replicas in Slack channels, or by messaging the bot directly.
- [Sentry](https://docs.replicas.dev/features/sentry.md): Fire automations from Sentry issue alerts and new errors.
- [Infisical](https://docs.replicas.dev/features/infisical.md): Sync Infisical secrets and use the CLI automatically in workspaces.
- [Doppler](https://docs.replicas.dev/features/doppler.md): Sync environment variables from Doppler into workspaces.
- [Automations](https://docs.replicas.dev/features/automations.md): Run agents on a schedule or in response to GitHub, GitLab, Slack, Sentry, or custom webhook events.
- [Learnings](https://docs.replicas.dev/features/learnings.md): Save your team's preferences as learnings that agents load automatically.
- [API](https://docs.replicas.dev/features/api.md): Create and control replicas from your own code.
- [CLI](https://docs.replicas.dev/features/cli.md): Control workspaces, chats, environments, and automations from your terminal.
- [MCP](https://docs.replicas.dev/features/mcp.md): Control Replicas from Claude, Cursor, and other MCP clients.
- [Plugins](https://docs.replicas.dev/features/plugins.md): Install tools for Replicas agents on an environment.
- [Mobile testing](https://docs.replicas.dev/features/mobile-testing.md): Build and test iOS and Android apps in cloud devices from a workspace.
- [GPU sandboxes](https://docs.replicas.dev/features/gpu-sandboxes.md): Run training, inference, and other GPU workloads on cloud GPUs from a workspace.
- [iOS app](https://docs.replicas.dev/features/mobile-app.md): Start, steer, and review cloud coding agents from your iPhone.
- [Desktop app](https://docs.replicas.dev/features/desktop-app.md): Run Replicas in a focused macOS, Windows, or Linux window.
- [Team](https://docs.replicas.dev/admin/team.md): Invite members and manage roles.
- [Defaults](https://docs.replicas.dev/admin/defaults.md): Org-wide defaults for agents, models, and workspaces.
- [Security policies](https://docs.replicas.dev/admin/security.md): Require user identity and code-host attribution, block agent merges, and manage static egress.
- [Audit Log](https://docs.replicas.dev/admin/audit-log.md): Track configuration changes across your organization.
- [Analytics](https://docs.replicas.dev/admin/analytics.md): See how much work Replicas is shipping for your organization.
- [Credentials](https://docs.replicas.dev/admin/credentials.md): Configure coding agents and integrations.
- [Profile](https://docs.replicas.dev/features/profile.md): Choose the name and photo teammates see in Replicas.
- [Billing](https://docs.replicas.dev/admin/billing.md): Plans, included usage, overage, and how you're charged.
- [Data Retention](https://docs.replicas.dev/admin/data-retention.md): How Replicas retains workspace data and how admins can turn retention off.
- [Changelog](https://docs.replicas.dev/changelog.md): Weekly product updates and announcements
- [List organization conversations](https://docs.replicas.dev/api-reference/replica/list-organization-conversations.md): Exports retained conversations from every replica without waking them. Requires an organization API key. Deleted chats and conversations outside your [data retention](/admin/data-retention) window are omitted.
- [List replicas](https://docs.replicas.dev/api-reference/replica/list-replicas.md): Lists replicas, newest first. With `status=archived`, sorted by most recent activity.
- [Create replica](https://docs.replicas.dev/api-reference/replica/create-replica.md): Creates a replica from an environment and sends the first message. Returns immediately with `status: "preparing"`; use `GET /v1/replica/{id}/wait` to wait for it. An organization can have 100 API and automation replicas active or preparing at once.
- [Get replica](https://docs.replicas.dev/api-reference/replica/get-replica.md): Returns the replica with its chats, repositories, and pull requests. Sleeping and archived replicas return their retained chats without waking. Use `include` for environment details and diffs.
- [Delete replica](https://docs.replicas.dev/api-reference/replica/delete-replica.md): Permanently deletes the replica and its sandbox.
- [Rename replica](https://docs.replicas.dev/api-reference/replica/rename-replica.md)
- [Send message](https://docs.replicas.dev/api-reference/replica/send-message.md): Sends a message to a chat. Sleeping replicas wake and archived replicas restore first. Messages sent while the agent is working are queued.
- [Read history](https://docs.replicas.dev/api-reference/replica/read-history.md): Reads history from the newest event. Omit `limit` for everything. To page back, pass the previous `before_cursor` until it is `null`. Sleeping and archived replicas return retained history without waking. Returns `409` when a suspended replica has no retained history.
- [Get hook logs](https://docs.replicas.dev/api-reference/replica/get-hook-logs.md): Returns warm hook and start hook logs.
- [Stream events](https://docs.replicas.dev/api-reference/replica/stream-events.md): Streams replica events as server-sent events (`data: <JSON>`). Each event has `id`, `ts`, `type`, `payload`, and on current engines a `seq`; see `EngineEvent` for types. The stream opens with an `engine.stream.opened` event, and each SSE `id:` line is `<epoch>:<seq>`: reconnect with that value in `L…
- [Wake replica](https://docs.replicas.dev/api-reference/replica/wake-replica.md): Starts waking a sleeping replica and returns `202` immediately. Set `restore=true` to also restore an archived replica. Replicas in `error` are retried. Sending a message wakes or restores a replica too.
- [Sleep replica](https://docs.replicas.dev/api-reference/replica/sleep-replica.md): Pauses compute. The replica keeps its files and wakes on the next message.
- [Archive replica](https://docs.replicas.dev/api-reference/replica/archive-replica.md): Archives a replica. Sending a message or waking with `restore=true` restores it.
- [List replica media](https://docs.replicas.dev/api-reference/replica/list-replica-media.md): Lists media the replica uploaded, newest first. Fetch a file with [Get a media download URL](/api-reference/media/get-a-media-download-url).
- [Wait for replica](https://docs.replicas.dev/api-reference/replica/wait-for-replica.md): Waits until the replica finishes starting and its agents finish their work, including background tasks they will wake up for, then returns its chats and activity. Without `chat_id`, background tasks count as work. Returns `done: false` after `timeout_seconds` (max 50) if work is still running, or as…
- [List chats](https://docs.replicas.dev/api-reference/chats/list-chats.md): Sleeping and archived replicas return their retained chats without waking.
- [Create chat](https://docs.replicas.dev/api-reference/chats/create-chat.md)
- [Delete chat](https://docs.replicas.dev/api-reference/chats/delete-chat.md)
- [Rename chat](https://docs.replicas.dev/api-reference/chats/rename-chat.md): The replica must be active.
- [List slash commands](https://docs.replicas.dev/api-reference/chats/list-slash-commands.md): Lists Replicas and agent slash commands available in the chat.
- [Restore chat](https://docs.replicas.dev/api-reference/chats/restore-chat.md): Restores a deleted chat. The replica must be active.
- [Interrupt chat](https://docs.replicas.dev/api-reference/chats/interrupt-chat.md): Stops the chat's current agent turn. Queued messages are discarded and returned in `removed_message_ids`.
- [Update chat goal](https://docs.replicas.dev/api-reference/chats/update-chat-goal.md): Sets the objective of a Codex chat, or pauses and resumes it. Other agents return `goal: null`; give them a goal by sending a message with `goal_mode: true`. The replica must be active.
- [Clear chat goal](https://docs.replicas.dev/api-reference/chats/clear-chat-goal.md)
- [Answer agent question](https://docs.replicas.dev/api-reference/chats/answer-agent-question.md): Answers a question or approval the agent is waiting on. Find pending requests in [Read history](/api-reference/replica/read-history): a tool call with `inputRequest.status` of `pending` carries the `request_id` and its option IDs.
- [Fork chat](https://docs.replicas.dev/api-reference/chats/fork-chat.md): Starts a new chat that continues from this chat's history, optionally on another coding agent and with a first message. The replica must be active.
- [Get queue](https://docs.replicas.dev/api-reference/message-queue/get-queue.md): Lists messages waiting for the agent to finish its turn.
- [Clear queue](https://docs.replicas.dev/api-reference/message-queue/clear-queue.md)
- [Reorder queued message](https://docs.replicas.dev/api-reference/message-queue/reorder-queued-message.md)
- [Remove queued message](https://docs.replicas.dev/api-reference/message-queue/remove-queued-message.md)
- [Edit queued message](https://docs.replicas.dev/api-reference/message-queue/edit-queued-message.md)
- [Steer with queued message](https://docs.replicas.dev/api-reference/message-queue/steer-with-queued-message.md): Adds the queued message to the agent's current turn without stopping it.
- [Send queued message now](https://docs.replicas.dev/api-reference/message-queue/send-queued-message-now.md): Sends the queued message right away instead of waiting for the turn to finish. Running commands keep going in the background.
- [Run command](https://docs.replicas.dev/api-reference/commands-and-terminals/run-command.md): Runs a shell command and returns its output and exit code. Commands that outlast `timeout_seconds` are stopped and return `timed_out: true`. Use a terminal session for interactive or long-running work. The replica must be active.
- [List terminal sessions](https://docs.replicas.dev/api-reference/commands-and-terminals/list-terminal-sessions.md)
- [Create terminal session](https://docs.replicas.dev/api-reference/commands-and-terminals/create-terminal-session.md): Opens an interactive shell. Read output from Stream terminal output and write with Send terminal input. A replica can have 8 sessions. The replica must be active.
- [Send terminal input](https://docs.replicas.dev/api-reference/commands-and-terminals/send-terminal-input.md): Writes keystrokes. Number writes with an increasing `sequence` and keep `generation` fixed for the session.
- [Resize terminal](https://docs.replicas.dev/api-reference/commands-and-terminals/resize-terminal.md)
- [Stream terminal output](https://docs.replicas.dev/api-reference/commands-and-terminals/stream-terminal-output.md): Server-sent events whose `data` is a JSON string of terminal output. The first event replays recent output.
- [Close terminal session](https://docs.replicas.dev/api-reference/commands-and-terminals/close-terminal-session.md)
- [Get SSH access](https://docs.replicas.dev/api-reference/commands-and-terminals/get-ssh-access.md): Returns a short-lived token and proxy command for SSH. The [CLI](/features/cli) runs this for you. The replica must be active.
- [Get pull requests](https://docs.replicas.dev/api-reference/pull-requests/get-pull-requests.md): Returns state, checks, reviews, and mergeability for up to 20 pull requests the replica opened. Get URLs from Get replica.
- [Merge pull request](https://docs.replicas.dev/api-reference/pull-requests/merge-pull-request.md): Merges a GitHub pull request when it is open and mergeable, or adds it to the merge queue when its base branch requires one. With `bypass_rules`, merges a blocked pull request with your GitHub account when it can bypass the branch's rules. Returns `403` when the organization's security policy blocks…
- [Update pull request](https://docs.replicas.dev/api-reference/pull-requests/update-pull-request.md): Closes, approves, converts to draft, or marks ready a GitHub pull request the replica opened. Approving uses your GitHub account, so it needs a personal API key with GitHub connected.
- [List previews](https://docs.replicas.dev/api-reference/previews/list-previews.md)
- [Create preview](https://docs.replicas.dev/api-reference/previews/create-preview.md): Creates a public URL for a port. Set `authenticated` to require Replicas sign-in. Port 3737 is reserved for the Replicas engine. The replica must be active.
- [Delete preview](https://docs.replicas.dev/api-reference/previews/delete-preview.md)
- [List Canvas files](https://docs.replicas.dev/api-reference/canvas/list-canvas-files.md): Lists plans, reports, and other files the agent put in the [Canvas](/features/workspaces/canvas).
- [Read Canvas file](https://docs.replicas.dev/api-reference/canvas/read-canvas-file.md)
- [Write Canvas file](https://docs.replicas.dev/api-reference/canvas/write-canvas-file.md): Replaces a text file. Pass `expected_revision` from Read Canvas file to avoid overwriting newer changes. The replica must be active.
- [List shares](https://docs.replicas.dev/api-reference/sharing/list-shares.md)
- [Share replica](https://docs.replicas.dev/api-reference/sharing/share-replica.md): Adds the replica to a member's **Shared** view. Only the owner can share a member's replica; anyone with access can share an organization-owned one.
- [Unshare replica](https://docs.replicas.dev/api-reference/sharing/unshare-replica.md)
- [List environments](https://docs.replicas.dev/api-reference/environments/list-environments.md): Lists environments you can use.
- [Create environment](https://docs.replicas.dev/api-reference/environments/create-environment.md): Creates an organization (`scope: "org"`) or personal (`scope: "user"`) environment. Set `source_environment_id` to create a live fork, as in Fork environment. Pass `repository_ids` to choose the repositories to clone.
- [Get environment](https://docs.replicas.dev/api-reference/environments/get-environment.md)
- [Delete environment](https://docs.replicas.dev/api-reference/environments/delete-environment.md): Also uninstalls its plugins. Forks of it, including other people's personal forks, are detached first. Returns `409` while automations use it.
- [Update environment](https://docs.replicas.dev/api-reference/environments/update-environment.md): Updates only the fields you send. Set `repository_ids` to `[]` to remove all repositories. `personal_preferences` can only be set on personal environments and is appended after the inherited system prompt.
- [Fork environment](https://docs.replicas.dev/api-reference/environments/fork-environment.md): Creates a live fork that inherits everything from this environment and stores only its own overrides and exclusions. Team environments fork into shared (`scope: "org"`, needs Read on the parent and counts toward your environment limit) or personal (`scope: "user"`, needs Read) forks; your own person…
- [Detach fork](https://docs.replicas.dev/api-reference/environments/detach-fork.md): Copies everything the fork inherits from its parents into the fork itself, then removes the link. Connected plugin accounts and MCP OAuth sign-ins can't be shared and are listed in `not_copied`.
- [Restore an earlier setup](https://docs.replicas.dev/api-reference/environments/restore-an-earlier-setup.md): Puts the environment back to the setup a build made live: its warm hook, repositories, variables, files, and skills, and the image built from them. New workspaces get it right away. If that image was already cleaned up, the restored settings are rebuilt (`rebuilding: true`). Builds keep their setup…
- [List hook runs](https://docs.replicas.dev/api-reference/environments/list-hook-runs.md): Recent warm hook runs (one per warm pool build attempt) and start hook runs (one per workspace start), newest first. The last 20 of each kind are kept.
- [Get hook run log](https://docs.replicas.dev/api-reference/environments/get-hook-run-log.md): A hook run with its output. Follow a running hook by polling with `offset` set to the previous `output_length`.
- [Get effective environment](https://docs.replicas.dev/api-reference/environments/get-effective-environment.md): Returns the environment's configuration folded over its chain (the root, then each ancestor, then the environment itself) with provenance for every variable, file, MCP, skill, skill registry, plugin, and secret-sync connection. System prompts are listed in the order they're combined. Values from env…
- [Exclude inherited item](https://docs.replicas.dev/api-reference/environments/exclude-inherited-item.md): Hides an inherited item from this environment and its forks. `DELETE` on an inherited variable, file, MCP, skill, or registry through this environment does the same. Locked variables can't be excluded (`409`).
- [Reset to inherited](https://docs.replicas.dev/api-reference/environments/reset-to-inherited.md): Removes this environment's override and exclusion for a key so the inherited value applies again. With `kind: "repository"`, `"memory"`, or `"default_skills"`, a fork clears its own repository binding, memory settings, or default skills.
- [List environment variables](https://docs.replicas.dev/api-reference/environment-variables/list-environment-variables.md): Returns variables with plaintext values.
- [Create environment variable](https://docs.replicas.dev/api-reference/environment-variables/create-environment-variable.md): Keys must start with a letter or underscore and contain only letters, digits, and underscores, and are unique per environment. Values are encrypted at rest. A fork can override any inherited key that is not `locked`.
- [Create environment variables](https://docs.replicas.dev/api-reference/environment-variables/create-environment-variables.md): Creates up to 200 variables at once, all or none. Counts as one change for the warm pool, so it rebuilds at most once.
- [Delete environment variable](https://docs.replicas.dev/api-reference/environment-variables/delete-environment-variable.md)
- [Update environment variable](https://docs.replicas.dev/api-reference/environment-variables/update-environment-variable.md): Updates only the fields you send.
- [List environment files](https://docs.replicas.dev/api-reference/environment-files/list-environment-files.md): Files are written to their `path` when a workspace starts.
- [Create environment file](https://docs.replicas.dev/api-reference/environment-files/create-environment-file.md): Content is limited to 64 KB. `path` must be under the home directory.
- [Delete environment file](https://docs.replicas.dev/api-reference/environment-files/delete-environment-file.md)
- [Update environment file](https://docs.replicas.dev/api-reference/environment-files/update-environment-file.md)
- [List environment skills](https://docs.replicas.dev/api-reference/environment-skills/list-environment-skills.md): Lists [skills.sh](https://skills.sh) skills installed into workspaces.
- [Enable environment skill](https://docs.replicas.dev/api-reference/environment-skills/enable-environment-skill.md): Enables a skill found with [Search skill catalog](/api-reference/environment-skills/search-skill-catalog). Returns `409` if it is already enabled.
- [Disable environment skill](https://docs.replicas.dev/api-reference/environment-skills/disable-environment-skill.md)
- [List skill registries](https://docs.replicas.dev/api-reference/environment-skills/list-skill-registries.md): Lists GitHub repositories used as skill registries, with the skills found in each.
- [Add skill registry](https://docs.replicas.dev/api-reference/environment-skills/add-skill-registry.md): Adds a GitHub repository as a skill registry. Its skills install into new workspaces.
- [Remove skill registry](https://docs.replicas.dev/api-reference/environment-skills/remove-skill-registry.md)
- [List repository skills](https://docs.replicas.dev/api-reference/environment-skills/list-repository-skills.md): Lists skills, agents, commands, and rules committed to the environment's repositories, read from the default branch. Returns an empty list when no repository is bound.
- [Search skill catalog](https://docs.replicas.dev/api-reference/environment-skills/search-skill-catalog.md): Searches [skills.sh](https://skills.sh).
- [List environment MCPs](https://docs.replicas.dev/api-reference/environment-mcps/list-environment-mcps.md)
- [Create environment MCP](https://docs.replicas.dev/api-reference/environment-mcps/create-environment-mcp.md): `name` must match `^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$` and cannot start with `relay-`, `replicas-`, or `subagents`. `stdio` takes `{ command, args, env }`; `http` and `sse` take `{ url, headers }`, or `auth` for [workspace identity](/features/workspaces/workspace-identity).
- [Delete environment MCP](https://docs.replicas.dev/api-reference/environment-mcps/delete-environment-mcp.md)
- [Update environment MCP](https://docs.replicas.dev/api-reference/environment-mcps/update-environment-mcp.md): Updates only the fields you send. Changing `transport` requires a matching `config`.
- [Get warm hook](https://docs.replicas.dev/api-reference/hooks/get-warm-hook.md): Returns the environment's warm hook, warm pool status, and up to 20 recent snapshots.
- [Save warm hook](https://docs.replicas.dev/api-reference/hooks/save-warm-hook.md): Saves and activates the warm hook without testing it. Empty content removes it.
- [Save and test warm hook](https://docs.replicas.dev/api-reference/hooks/save-and-test-warm-hook.md): Runs the script in a new sandbox and activates it only if it passes. Takes 30–90 seconds.
- [Test warm hook](https://docs.replicas.dev/api-reference/hooks/test-warm-hook.md): Runs the script in a new sandbox without saving it. Takes 30–90 seconds.
- [Get start hook](https://docs.replicas.dev/api-reference/hooks/get-start-hook.md): Returns the environment's start hook. Start hooks run when a workspace starts, before repository hooks.
- [Save start hook](https://docs.replicas.dev/api-reference/hooks/save-start-hook.md): Saves and activates the start hook. Empty content removes it. Does not rebuild the warm pool.
- [Test start hook](https://docs.replicas.dev/api-reference/hooks/test-start-hook.md): Runs the script in a new sandbox without saving it. Takes 30–90 seconds.
- [Test start hook (streaming)](https://docs.replicas.dev/api-reference/hooks/test-start-hook-streaming.md): Same as [Test start hook](/api-reference/hooks/test-start-hook), streamed as server-sent events: `progress`, `output`, `complete`, and `error`.
- [Enable or disable warm pool](https://docs.replicas.dev/api-reference/warm-pools/enable-or-disable-warm-pool.md)
- [Refresh warm pool](https://docs.replicas.dev/api-reference/warm-pools/refresh-warm-pool.md): Rebuilds the warm pool from the latest code and hooks. Limited to once every two minutes.
- [Start queued warm pool build](https://docs.replicas.dev/api-reference/warm-pools/start-queued-warm-pool-build.md): Edits queue a warm pool build that starts after 45 seconds without further edits, at most 3 minutes after the first. This starts the queued build right away, or retries the current build if it failed.
- [Restore warm pool snapshot](https://docs.replicas.dev/api-reference/warm-pools/restore-warm-pool-snapshot.md): Rebuilds the warm pool from an earlier snapshot without rerunning the warm hook. The current pool serves until the new one is ready.
- [List warm pool workspaces](https://docs.replicas.dev/api-reference/warm-pools/list-warm-pool-workspaces.md): Lists the 10 most recent pre-built workspaces and their status. Use it to debug a pool that is not producing ready workspaces.
- [Stream warm pool workspace updates](https://docs.replicas.dev/api-reference/warm-pools/stream-warm-pool-workspace-updates.md): Streams warm hook output and status changes as server-sent events: `output`, `status`, `complete`, and `error`. Output is only available while the workspace is `warming`. Closes when the workspace finishes.
- [List automations](https://docs.replicas.dev/api-reference/automations/list-automations.md)
- [Create automation](https://docs.replicas.dev/api-reference/automations/create-automation.md): See [Automations](/features/automations) for triggers and lifecycle policies.
- [List all executions](https://docs.replicas.dev/api-reference/automations/list-all-executions.md): Lists runs across every automation you can read, newest first.
- [Get automation](https://docs.replicas.dev/api-reference/automations/get-automation.md)
- [Delete automation](https://docs.replicas.dev/api-reference/automations/delete-automation.md): Also deletes its run history.
- [Update automation](https://docs.replicas.dev/api-reference/automations/update-automation.md): Updates only the fields you send. `triggers` replaces all triggers.
- [Trigger automation](https://docs.replicas.dev/api-reference/automations/trigger-automation.md): Runs the automation now in a new workspace. For a `pull_request.command` trigger, pass `pr` to choose the pull request.
- [List automation executions](https://docs.replicas.dev/api-reference/automations/list-automation-executions.md)
- [Retry automation execution](https://docs.replicas.dev/api-reference/automations/retry-automation-execution.md): Replays a failed run's trigger in a new workspace with the automation's current settings.
- [List repositories](https://docs.replicas.dev/api-reference/repositories/list-repositories.md)
- [List repository branches](https://docs.replicas.dev/api-reference/repositories/list-repository-branches.md): Returns up to 100 branches. Use `q` to search by prefix.
- [List connectable GitHub repositories](https://docs.replicas.dev/api-reference/repositories/list-connectable-github-repositories.md): Lists repositories the organization's GitHub App installations can reach, with the IDs Add repository needs.
- [Add repository](https://docs.replicas.dev/api-reference/repositories/add-repository.md): Connects a repository. GitHub repositories must come from List connectable GitHub repositories. Requires an organization admin's personal API key.
- [Remove repository](https://docs.replicas.dev/api-reference/repositories/remove-repository.md): Disconnects a repository. Returns `409` while an environment or active workspace uses it. Requires an organization admin's personal API key.
- [Update repository](https://docs.replicas.dev/api-reference/repositories/update-repository.md): Changes the default branch. Requires an organization admin's personal API key.
- [List learnings](https://docs.replicas.dev/api-reference/learnings/list-learnings.md)
- [Create learning](https://docs.replicas.dev/api-reference/learnings/create-learning.md): Adds a learning. Every new workspace loads it.
- [Update learning](https://docs.replicas.dev/api-reference/learnings/update-learning.md)
- [Delete learning](https://docs.replicas.dev/api-reference/learnings/delete-learning.md)
- [List models](https://docs.replicas.dev/api-reference/agent-credentials/list-models.md): Uses the workspace selection or harness credential priority. Before workspace creation, pass method and scope to preview a connected inference provider. Returns provider editability and an optional default model; null requires explicit selection.
- [Get organization credential](https://docs.replicas.dev/api-reference/agent-credentials/get-organization-credential.md): Organization credentials apply to every member. Changing them requires an admin's personal API key.
- [Set organization credential](https://docs.replicas.dev/api-reference/agent-credentials/set-organization-credential.md): Organization credentials apply to every member. Changing them requires an admin's personal API key. The key is checked with the provider where possible. A new `opencode-go` key is added after the existing ones, up to 10, and deleting removes them all.
- [Delete organization credential](https://docs.replicas.dev/api-reference/agent-credentials/delete-organization-credential.md)
- [Get personal credential](https://docs.replicas.dev/api-reference/agent-credentials/get-personal-credential.md): Personal credentials take priority over organization ones and need a personal API key.
- [Set personal credential](https://docs.replicas.dev/api-reference/agent-credentials/set-personal-credential.md): Personal credentials take priority over organization ones and need a personal API key. The key is checked with the provider where possible. A new `opencode-go` key is added after the existing ones, up to 10, and deleting removes them all.
- [Delete personal credential](https://docs.replicas.dev/api-reference/agent-credentials/delete-personal-credential.md)
- [List credentials for an agent](https://docs.replicas.dev/api-reference/agent-credentials/list-credentials-for-an-agent.md): Lists the credential methods connected for a coding agent and which one workspaces use.
- [Get subscription usage](https://docs.replicas.dev/api-reference/agent-credentials/get-subscription-usage.md): Reads live from Anthropic and OpenAI how much of each connected Claude and ChatGPT subscription's 5-hour and weekly limits is used. Muse Code and OpenCode Go do not report usage. Without `scope`, returns your personal subscriptions followed by the organization's, each in the order workspaces use the…
- [List plugins](https://docs.replicas.dev/api-reference/plugins/list-plugins.md): Lists every [plugin](/features/plugins) and which are connected for the environment.
- [Connect plugin](https://docs.replicas.dev/api-reference/plugins/connect-plugin.md): Connects a plugin that uses credentials, such as an API key. Credentials are verified with the provider. For OAuth plugins, use Start plugin OAuth. Requires write access to the environment.
- [Start plugin OAuth](https://docs.replicas.dev/api-reference/plugins/start-plugin-oauth.md): Returns an `authorization_url` for a person to open. The connection is saved when they approve. The authorization is tied to a person, so this needs a personal API key or the app. Requires write access to the environment.
- [Disconnect plugin](https://docs.replicas.dev/api-reference/plugins/disconnect-plugin.md): Removes the plugin's connections from the environment and revokes their authorization.
- [Get current identity](https://docs.replicas.dev/api-reference/organization/get-current-identity.md): Shows the organization and identity the request acts as, and whether it has admin rights.
- [List members](https://docs.replicas.dev/api-reference/organization/list-members.md): Lists members with their user IDs, for sharing workspaces and filtering by owner.
- [Get a media download URL](https://docs.replicas.dev/api-reference/media/get-a-media-download-url.md): Returns a short-lived URL that downloads the file.
- [Get a media preview URL](https://docs.replicas.dev/api-reference/media/get-a-media-preview-url.md): Returns a short-lived URL that renders the file inline. Sandbox HTML previews.
- [Get media metadata](https://docs.replicas.dev/api-reference/media/get-media-metadata.md)
- [Attach Slack thread](https://docs.replicas.dev/api-reference/slack/attach-slack-thread.md): Routes replies in a Slack thread to a workspace.
- [Get workspace identity discovery document](https://docs.replicas.dev/api-reference/workspace-identity/get-workspace-identity-discovery-document.md): OIDC discovery document for [workspace identity](/features/workspaces/workspace-identity) tokens. No authentication.
- [Get workspace identity signing keys](https://docs.replicas.dev/api-reference/workspace-identity/get-workspace-identity-signing-keys.md): Public keys for verifying workspace identity tokens, including staged rotation keys. No authentication.
- [Get workspace identity configuration](https://docs.replicas.dev/api-reference/workspace-identity/get-workspace-identity-configuration.md): Returns the issuer, discovery, and JWKS URLs for [workspace identity](/features/workspaces/workspace-identity) tokens. Tokens are minted inside workspaces, not through the API.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.