Authentication
Connect to Replicas using an API key created from the Replicas dashboard under Organization → Settings → API Keys.Connection details
Replicas actions
Launch agent
Create a workspace and send an initial message to a coding agent. Configuration
The Environment dropdown lists the team and personal environments in your Replicas
organization. The Global environment is not listed: it only layers configuration onto the
other environments and has no repository binding, so it cannot back a workspace.
Leave Workspace name empty to get a name derived from the workflow node and the record
being processed.
Waiting for the agent
The node stays pending until Replicas calls back, so downstream nodes run against a
finished agent rather than a workspace that has only just started. Replicas notifies Cargo
directly — nothing is polled — and the node resumes on the
replica.turn_completed
callback. A replica.error callback fails the node with the reason Replicas reported.
Output
Use cases
Automated code changes
Automated code changes
Turn a qualified request into a branch and a pull request without a human in the loop.
Codebase research
Codebase research
Ask an agent to investigate a repository and feed its findings into the rest of the workflow.
Triage at scale
Triage at scale
Launch one agent per incoming issue and collect the pull requests they open.
Scheduled maintenance
Scheduled maintenance
Run dependency bumps or migrations on a schedule and review the resulting pull requests.
Best practices
- Give the agent a complete prompt - It cannot ask follow-up questions mid-run
- Pick the environment carefully - It decides which repository the agent works on
- Use plan mode to review first - Have the agent propose an approach before it writes code
- Sleep or archive when done - Workspaces bill per minute while they stay up

