v36

latestOpenAPI 3.1.0raw.githubusercontent.com2025-10-091882241.2 MB
agents

List Agent Files

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

get/v1/agents/{agent_id}/files

Path parameters

agent_idstring required

Query parameters

beforestring nullable

File ID cursor for pagination. Returns files that come before this file ID in the specified sort order

File ID cursor for pagination. Returns files that come before this file ID in the specified sort order

afterstring nullable

File ID cursor for pagination. Returns files that come after this file ID in the specified sort order

File ID cursor for pagination. Returns files that come after this file ID in the specified sort order

limitinteger nullable

Maximum number of files to return

Maximum number of files to return

order'asc' | 'desc'

Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first

Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first

order_by'created_at'

Field to sort by

Field to sort by

cursorstring nullable

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

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

is_openboolean nullable

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

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

Response

Successful Response

next_cursorstring nullable

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

has_moreboolean required

Whether more results exist after this page