# List files

Paginate only the files owned by the current account.

`GET /v1/files`

## Availability

This page preserves the corresponding public documentation URL. The endpoint is not enabled for public use yet. A request example describes the intended interface, not a claim of deployed support. Consult the capability matrix and your access configuration before integration.

## Pagination

The implemented interface accepts limit=1..100 (default 20), after as an owned visible file id, order=asc or desc (default desc), and optional purpose=user_data. Ordering is by creation time and id. Duplicate or unknown parameters are rejected. Expired, unfinished and deleting files are not visible. An API key may never enumerate another account’s files.

## Response

A list contains data, first_id, last_id and has_more. Continue using the returned cursor rather than guessing file identifiers. Files are private and must not be exposed as public object-store URLs.