Skip to content

List Files

GET
/api/v3/organizations/{organisation}/ai/files

Lists files stored in S3 for this organization with optional metadata filtering and pagination.

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

Query Parameters

filter
string
{}

JSON-encoded metadata filter. Supports exact match and array contains filters.

limit
integer
default: 50 <= 200

Maximum files to return

cursor
string

Pagination cursor from previous response

Responses

200

List of files

object
files
Array<object>
object
fileId
string format: uuid
filename
string
contentType
string
size
integer
metadata
object
createdAt
string format: date-time
nextCursor

Cursor for next page

string
nullable
hasMore

True if more results available

boolean

400

Invalid filter parameter

403

Access denied

500

Failed to list files