Skip to main content
POST
Confirm your deployment before running this request. This page describes an API contract; a published reference does not establish hosted availability. Check the dated host report and obtain your deployment URL and credentials. Replace the example host if your provisioned service uses a different URL.
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

Headers

string,null

Request body

No request body.

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

Using this contract

Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.
Last modified on September 21, 2026