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
- Creates a new evaluation for the job (with current spec)
- Scheduler re-analyzes node matching and placement
- Creates/updates/stops executions as needed
- 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}/stopinstead - 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
- 200
- 400
- 404
- 500
Evaluation created
Invalid job ID or rerun request
Job not found
Internal Server Error