Operations and results#
GET /v1/operations/{id}
Every admitted request has an operation ID. Use this route with a read-scoped key to inspect saved inputs, state, retained results and credits. For a crawl's paginated result envelope, use its dedicated job URL.
curl https://api.luni.gg/v1/operations/$OPERATION_ID \
-H "Authorization: Bearer $LUNI_API_KEY"| State | Meaning |
|---|---|
queued | Admitted with reserved credits; execution has not started. |
running | A worker owns the operation and may have stored partial results. |
completed | Execution finished. Check retained results and creditsUsed. |
failed | Execution could not finish. Inspect error and any retained completed units. |
cancelled | Cancellation stopped further work; completed units remain. |
expired | The execution deadline passed. Inspect any retained results. |
Results are retained for seven days from result creation. Metadata may outlive content; expiredResults reports that content expired. A completed synchronous replay whose result expired returns 410 RESULT_EXPIRED. Use a new identity only when you intentionally want to collect and pay for a fresh result.
Use the returned state instead of inferring success from a submission's HTTP 200. Poll with backoff while a job is queued or running. A missing operation and an operation belonging to another workspace both return 404.