Skip to main content
GET
List files

Authorizations

Authorization
string
header
required

The workspace API key (pdk_…) from Integrations → Built-in in the pre.dev dashboard.

Query Parameters

limit
integer
default:20

Files per page, 1 to 50.

Required range: 1 <= x <= 50
order
enum<string>
default:desc

desc for newest first, asc for oldest first.

Available options:
desc,
asc
after
string

A file id from an earlier page, usually its last_id. It must be one of this workspace's files, or the call returns 404 not_found.

purpose
string

Only files with this purpose, for example user_data.

Response

One page of files.

One page of this workspace's files. To read the next page, pass last_id as after while has_more is true.

object
string
required
Allowed value: "list"
data
object[]
required

Files this workspace uploaded through the gateway, in the requested order.

first_id
string | null
required

Id of the first file in data; null when the page is empty.

last_id
string | null
required

Id of the last file in data; pass it as after for the next page. null when the page is empty.

has_more
boolean
required

More files remain after this page.

predev
object

Present only when files were skipped.