Skip to main content
POST
Clone any job’s params + template + agent_mode into a fresh queued run. Difference from /replay-as-new (succeeded only) and /retry (failed/cancelled only): this works for any source status including running and awaiting_approval. Useful when you want to fork an in-flight run rather than wait for it to terminate, or copy a config from a long-lived sandbox session into a one-off task. Source row is never modified; the new job is independent. Quota is charged as a brand-new task. Idempotency. Pass an Idempotency-Key header to make the duplicate replay-safe: a retried POST returns the original duplicate’s job id with Idempotency-Replayed: true instead of creating another. The key is namespaced per source job so the same caller key can be reused across different sources without collision.

Path parameters

string (uuid)
required

Response

TriggerResponse
string
required
UUID of the queued job. Use it for subsequent /jobs/:id calls.
string
required
Initial job status — usually ‘queued’. Replays of an idempotent request return the existing job’s current status.

Status codes