API reference
List jobs
Your workspace's jobs, newest first.
GET /v1/jobs
Host https://api.open.sume.com · Auth API key
Returns jobs newest first, one page at a time. Pass next_cursor back as starting_after for the next page. Find a job you lost track of by its idempotency_key.
Request
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer <key>. Or send x-api-key. |
Query
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | No | 1–100 jobs per page. |
status | string | No | queued, processing, completed, failed or canceled. |
type | string | No | A job type, such as image_generation or video_generation. |
starting_after | string | No | The next_cursor from the previous page. |
Example
List jobs
GET /v1/jobs?limit=20
Response
200 OK
Errors
| Status | code | When |
|---|---|---|
| 400 | invalid_request | A query value is out of range. |
| 401 | unauthorized | No key, or the key is wrong or revoked. |
| 429 | rate_limited | Too many requests for your key in this window. |