Retry Job V1
Re-queue a failed or cancelled job with the same params. Creates a NEW job record (new id, new idempotency key namespace) so the original run remains intact…
POST
Re-queue a failed or cancelled job with the same params.
Creates a NEW job record (new id, new idempotency key namespace) so
the original run remains intact for audit. The retry inherits the
source job’s
template, params, and agent_mode, then enters the
queue identically to a /trigger call.
Only failed and cancelled jobs can be retried; in-flight or
already-succeeded jobs return 409.
Idempotency. Pass an Idempotency-Key header to make the retry
replay-safe: a duplicate POST returns the original retry’s job id and
sets Idempotency-Replayed: true rather than queueing a second run.
The key is namespaced per source job, so the same key is reusable
across different source jobs 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.