GET
List files

Authorizations

Authorization
string
header
required

An opaque BMA personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$

Query Parameters

limit
integer<int32>

Page size (1-1000, default 20).

Required range: 1 <= x <= 1000
page
string

next_page from the previous response. Omit for the first page.

scope_id
string

Only files scoped to this session (ses_...).

Pattern: ^ses_[a-z2-7]{26}$
metadata
string[]

Label filter as key:value, for example beework_space_id:sp_123. Repeat to require several labels.

Maximum array length: 16
Pattern: ^[A-Za-z0-9_.-]{1,64}:

Response

Files.

data
object[]
required
next_page
string | null
required

Cursor for the next page; null when there are no more files.