Skip to main content

Rerun Job

PUT 

/jobs/:id/rerun

Triggers a new scheduler evaluation without changing the job specification.

What Rerun Means

Rerun creates a new evaluation to force the scheduler to reassess the job. This is different from updating a job (PUT /jobs):

  • Rerun: Job spec stays the same, scheduler re-evaluates
  • Update: Job spec changes, triggers new evaluation

When to Use

  • Job failed to schedule: Force re-evaluation after fixing node issues
  • Nodes changed: New nodes added or labels updated since last deployment
  • Stuck evaluation: Evaluation is blocked or pending for too long
  • Manual retry: After resolving external issues (network, resources, etc.)

What Happens

  1. Creates a new evaluation for the job (with current spec)
  2. Scheduler re-analyzes node matching and placement
  3. Creates/updates/stops executions as needed
  4. Returns immediately (async operation)

When NOT to Use

  • To change job configuration: Use PUT /jobs/{id} instead
  • To stop a job: Use POST /jobs/{id}/stop instead
  • If job is already running correctly: Rerun is unnecessary

Common Scenarios

  • "Job shows 'blocked - no nodes match selector'" → Added matching nodes → Rerun
  • "Updated node labels" → Rerun jobs that target those labels
  • "Network issue resolved" → Rerun jobs that failed to deploy

Request

Responses

Evaluation created