Skip to main content
POST
Trigger Automation

Authorizations

Authorization
string
header
required

API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. User-session JWTs are not accepted by /v1/replica endpoints.

Path Parameters

id
string<uuid>
required

The unique identifier of the automation

Body

application/json

Request body for manually triggering an automation

payload
object

Optional payload to pass to the automation execution

pr
object

Run the automation against a specific pull request. Only allowed for automations with a GitHub pull_request.command trigger matching the repository. The PR context is injected into the prompt like any other PR-triggered run.

Response

Automation triggered successfully

Response after triggering an automation

execution_id
string<uuid>
required

Unique identifier for the execution

workspace_id
string<uuid> | null
required

The workspace created for this execution