agentsFiles

List Files For Agent

Get the files attached to an agent with their open/closed status.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Path parameters

agent_idstringRequiredformat: "^agent-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"=42 characters

The ID of the agent in the format ‘agent-<uuid4>’

Query parameters

beforestring or nullOptional
File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
afterstring or nullOptional
File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
limitinteger or nullOptionalDefaults to 100
Maximum number of files to return
orderenumOptionalDefaults to desc
Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
Allowed values:
order_by"created_at"Optional
Field to sort by
cursorstring or nullOptionalDeprecated

Pagination cursor from previous response (deprecated, use before/after)

is_openboolean or nullOptional

Filter by open status (true for open files, false for closed files)

Response

Successful Response
fileslist of objects
List of file attachments for the agent
has_moreboolean
Whether more results exist after this page
next_cursorstring or null

Cursor for fetching the next page (file-agent relationship ID)

Errors