API Reference

Pagination

Cursor-based pagination for every list endpoint.

Ceevee uses cursor pagination, never offset pagination. Cursors are HMAC-signed, so tampering is detected and the API will reject a forged value with 400 invalid_cursor.

Request

limit — integer, default 25, max 100. The API may return fewer items than requested.
cursor — opaque string from a previous response's next_cursor. Omit for the first page.

curl 'https://api.ceevee.cc/v1/jobs?limit=50' \
  -H 'Authorization: Bearer ceevee_sk_live_…'

Response

Every list endpoint returns an envelope with object: "list", the data array, a boolean has_more, and next_cursor (null when the list is exhausted).

{
  "object": "list",
  "data": [ /* items */ ],
  "has_more": true,
  "next_cursor": "eyJ0cyI6IjIwMjYtMDQtMjlUMDk6MDA6MDBaIiwic2lnIjoiYWJjLi4uIn0"
}

Iterating

To page through every item: keep calling the same endpoint, passing the previous response's next_cursor, until has_more is false.