Tools
files_list
The organization's uploaded files, newest first, keyset-paginated.
The organization’s uploaded files, newest first, keyset-paginated. Pass ids to fetch a specific set (poll a whole upload batch in one call), or filter by readiness/kind.
Input
| Field | Type | Required | Description |
|---|---|---|---|
organization | string | no | Organization slug to act in (see organizations_list). Optional: API keys are bound to one organization; OAuth connections default to your active organization. |
ids | array | no | Fetch exactly these file ids — poll a whole upload batch in one call |
readiness | "ready" | "processing" | "failed" | no | |
kind | "image" | "video" | no | |
limit | integer | no | |
cursor | string | no | next_cursor from a prior page for keyset pagination |
Result
JSON on success. A refusal comes back as an error prefixed with its code (NOT_FOUND, FORBIDDEN, TOO_MANY_REQUESTS, …) and a message written to be acted on — read it before retrying.
The same operation elsewhere
This tool and the REST operation filesList and the CLI command inklate files list run the same guarded procedure the dashboard uses — same permissions, same validation, same tenant isolation.