Job Schema
JSON:API schema for background job resources
| Field | Type | Description |
|---|
id | string | Unique job identifier |
type | string | Job type |
status | string | Current status |
attempts | integer | Number of attempts made |
maxAttempts | integer | Maximum retry attempts |
error | string? | Error message if failed |
createdAt | string | ISO 8601 creation timestamp |
updatedAt | string | ISO 8601 update timestamp |
startedAt | string? | ISO 8601 start timestamp |
completedAt | string? | ISO 8601 completion timestamp |
| 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 |
pending — Queued, not yet startedprocessing — Currently executingcompleted — Finished successfullyfailed — Failed after retriesretrying — Retry in progress
- 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
