Uploads List Uploads
uploads_list_uploadsRead-onlyIdempotent
List the org's uploads, newest first, hiding cancelled rows by default.
Cancelled uploads are useless — the file may have been written to
storage but the download endpoint refuses to serve it (status gate
is confirmed only). They just clutter the picker, so the UI gets
them filtered out unless an admin explicitly opts in via
?include_cancelled=true (e.g. for an audit view).
The response is a plain array, so the page position travels in the
Link (RFC 8288) and X-Next-Cursor / X-Has-More response headers:
follow Link rel="next" until it stops being sent.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return in one page. | |
| order | No | Sort direction over the collection's ordering key. Use `asc` to reconcile a batch: rows come oldest-first, so work created while you page lands after your position instead of shifting rows under it. | desc |
| cursor | No | Opaque position token from the previous page's `next_cursor` (or the `Link` / `X-Next-Cursor` response header). Omit it for the first page. Keep every other query parameter identical for the whole walk — a cursor replayed against different filters is rejected. | |
| created_after | No | Only rows created at or after this instant (RFC 3339, e.g. `2026-07-20T09:00:00Z`). Inclusive. | |
| created_before | No | Only rows created strictly before this instant (RFC 3339). Exclusive, so an `after`/`before` pair tiles a range without overlap. | |
| include_cancelled | No | Include cancelled uploads in the list (hidden by default). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | This page's rows, in the order and shape the REST list returns them. | |
| has_more | Yes | False on the last page. Stop on this, never on a short page. | |
| next_cursor | Yes | Pass as `cursor` to read the next page. Null on the last page. |