Jobs
Background job tracking, retry, and status
Jobs
Jobs represent asynchronous operations such as instance creation, deletion, and power actions.
List Jobs
GET /v1/jobsReturns paginated list of jobs for the current project.
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Items per page (default: 20) |
status | string | Filter by status |
instanceId | string | Filter by instance |
Get Job
GET /v1/jobs/:idFailed Jobs
GET /v1/jobs/failedReturns all jobs with failed status.
Retry Failed Job
POST /v1/jobs/:id/retryRetries a failed job with the same payload.
Job Status Values
| Value | Description |
|---|---|
pending | Queued, not yet started |
processing | Currently executing |
completed | Finished successfully |
failed | Failed after retries |
retrying | Retry in progress |
Retry Behavior
- Failed jobs are retried up to 3 times with exponential backoff
- Retry delays: ~5s, ~25s, ~125s
- After max retries, job moves to dead-letter queue
- Failed jobs can be manually retried via
POST /v1/jobs/:id/retry
Job Types
| Type | Description |
|---|---|
instance.create | Provisioning a new instance |
instance.delete | Terminating an instance |
instance.action | Power action (start/stop/restart) |
instance.reinstall | Reinstalling OS |
reconcile-instances | Background status sync |