Sign in
files

List files

Returns a list of files owned by the specified owner.

get/api/v1/files

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/files
  • Auth: HTTP bearer

Query parameters

limitinteger nullable

Maximum number of files to return (default: 20, max: 100)

order'asc' | 'desc'

Sort order for list queries.

OpenAI-compatible sort order parameter for paginated list endpoints.

Sort order by created_at timestamp (default: desc)

afterstring nullable

Cursor for forward pagination. Returns results after this file ID.

beforestring nullable

Hadrian Extension: Cursor for backward pagination. Returns results before this file ID.

purposestring nullable

Filter by purpose

owner_typestring required

Hadrian Extension: Owner type for multi-tenancy (organization, project, or user)

owner_idstring uuid required

Hadrian Extension: Owner ID for multi-tenancy

Response

List of files

first_idstring nullable

ID of the first file in the list

has_moreboolean required

Whether there are more results available

last_idstring nullable

ID of the last file in the list

objectstring required

Object type (always "list")

Example response

{
  "data": [
    {
      "id": "file-550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.