Job endpoints
After submitting a job, poll status and download the result.
Get job status
GET /job/{id}
X-Fast-Api-Key: YOUR_API_KEYTypical statuses:
| Status | Meaning |
|---|---|
queued | The job is waiting to start. |
running | The job is processing. |
succeeded | The ZIP is ready. |
failed | The job failed; inspect the stable error code. |
canceled | The job was canceled. |
Poll with backoff. A practical starting point is every 1 to 2 seconds while queued or running, then slower after repeated unchanged responses.
Download result
GET /job/{id}/download
X-Fast-Api-Key: YOUR_API_KEYDownloads a ZIP when the job has succeeded. The ZIP is deleted automatically after the configured retention window.
Cancel job
POST /job/{id}/cancel
X-Fast-Api-Key: YOUR_API_KEYCancellation mirrors the other Tools.FAST APIs. It can cancel queued or running work when the job state allows it. If a charged job is canceled or fails after debit, refund handling follows the service billing state machine.
Delete job
DELETE /job/{id}
X-Fast-Api-Key: YOUR_API_KEYDeletes job metadata and stored artifacts when the job is accessible to the caller and the state allows deletion.