Files
List files
List the files in your namespace, newest first. Keyset-paginated: when has_more is true, pass next_cursor back as cursor.
get/files
Query parameters
limitinteger
Maximum files to return (1–100). Defaults to 25.
cursorstring
Opaque pagination cursor from a prior response's next_cursor.
state'pending' | 'ready' | 'failed' | 'deleted'
Lifecycle state of an uploaded file. pending until bytes are received and the ingest pipeline runs; ready once it can be referenced from a generation; failed if ingest/moderation rejected it; deleted after a soft-delete.
Filter to files in this state.
purpose'input' | 'reference'
How the file is intended to be used in a generation. input is the primary subject (e.g. the source image for an edit); reference is style/content guidance.
Filter to files with this purpose.
Response
A page of files