List files
Returns the caller organization’s files, newest first, one page at a time: up to limit files (default 200, at most 1000) and a next_page_token while more follow. Deleted files are omitted; an expired file stays listed, with expires_at in the past, until it is removed after a grace period, so a client that wants only attachable files filters on expires_at. Filter to one session’s outputs with scope_session_id or by source. A file_ids lookup (at most 100 ids) is always one page and cannot be combined with limit or page_token.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization 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.
1Query Parameters
Return only the files this session produced.
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.
100Return only uploads or only session outputs.
upload, session_output Maximum files to return per page; defaults to 200, newest first.
1 <= x <= 1000Opaque 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.