Skip to main content
GET
List files

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Query Parameters

scopeSessionId
string<uuid>

Return only files this session produced; use its lowercase canonical UUID.

Minimum string length: 1
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
fileIdAny
string<uuid>[]

Repeat lowercase canonical UUID file ids to resolve visible files in one page.

Required array length: 1 - 100 elements
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
source
enum<string>

Return uploads or session outputs.

Available options:
upload,
session_output
limit
integer

Maximum files to return; defaults to 200.

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

Opaque continuation from nextCursor; keep the same filters and limit.

Response

OK

items
object[]
required

Matching files, newest first. May be empty while nextCursor is non-null; continue until nextCursor is null.

nextCursor
null | string
required

Opaque cursor for the next page, or null.

total
null | integer
required

Always null; the file store does not count matching files for a list.

Required range: 0 <= x <= 9007199254740991