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

scope_session_id
string

Return only the files this session produced.

file_ids
string[]

Return only these files, comma-separated or repeated, for resolving a session's attachments in one read. At most 100 ids, answered as one page: limit and page_token are refused alongside it, an id that names nothing visible is left out rather than reported, and a file_ids that names no id at all answers no files.

Maximum array length: 100
source
enum<string>

Return only uploads or only session outputs.

Available options:
upload,
session_output
limit
integer

Maximum files to return per page; defaults to 200, newest first.

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

Opaque cursor from a previous response's next_page_token. Send it with the same filters and limit the previous page used, even if that page had no files; a token issued for a different query, organization, or collection is refused.

Response

Response body of GET /managed-agents/v1/files.

Response body of GET /managed-agents/v1/files.

files
object[] | null
required

Matching files in the caller's organization, newest first. May be empty even when next_page_token is present.

next_page_token
string

Cursor for the next page. Pass it back as page_token with the same filters and limit until no token remains.