Skip to main content
GET
List Files
Not available yet. The app-scoped Files API (/api/v1/files*) is not implemented — calls will 404. The read_files / write_files scopes are reserved in the OAuth catalog (requestable for forward-compat) but no file endpoints are bound. The shapes below are the planned contract and may change. To read/write theme assets today use the Themes assets endpoints (read_themes / write_themes); to pick existing media in an embedded UI use the App Bridge file resource picker (no app scope required).

Query Parameters

page
number
default:"1"
Page number
limit
number
default:"50"
Items per page (max 250)
type
string
Filter by file type: image, video, document

Response

The planned contract returns the standard response envelope. The data object holds the file rows plus pagination counters.
status
integer
HTTP status code (e.g. 200)
state
string
Response state: success or error
message
string
Human-readable message (null on success)
data
object