List Files For Agent

get/v1/agents/{agent_id}/files

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

Path ParametersExpand Collapse

agent_id: string

The ID of the agent in the format 'agent-'

minLength42

maxLength42

Query ParametersExpand Collapse

after: optional string

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

before: optional string

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

Deprecatedcursor: optional string

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

is_open: optional boolean

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

limit: optional number

Maximum number of files to return

order: optional "asc" or "desc"

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

Accepts one of the following:

"asc"

"desc"

order_by: optional "created_at"

Field to sort by

Accepts one of the following:

"created_at"

ReturnsExpand Collapse

files: array of object { id, file_id, file_name, 7 more }

List of file attachments for the agent

id: string

Unique identifier of the file-agent relationship

file_id: string

Unique identifier of the file

file_name: string

Name of the file

folder_id: string

Unique identifier of the folder/source

folder_name: string

Name of the folder/source

is_open: boolean

Whether the file is currently open in the agent's context

end_line: optional number

Ending line number if file was opened with line range

last_accessed_at: optional string

Timestamp of last access by the agent

formatdate-time

start_line: optional number

Starting line number if file was opened with line range

visible_content: optional string

Portion of the file visible to the agent if open

has_more: boolean

Whether more results exist after this page

next_cursor: optional string

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

List Files For Agent

curl https://api.letta.com/v1/agents/$AGENT_ID/files \
    -H "Authorization: Bearer $LETTA_API_KEY"

{
  "files": [
    {
      "id": "id",
      "file_id": "file_id",
      "file_name": "file_name",
      "folder_id": "folder_id",
      "folder_name": "folder_name",
      "is_open": true,
      "end_line": 0,
      "last_accessed_at": "2019-12-27T18:11:19.117Z",
      "start_line": 0,
      "visible_content": "visible_content"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}

Returns Examples

{
  "files": [
    {
      "id": "id",
      "file_id": "file_id",
      "file_name": "file_name",
      "folder_id": "folder_id",
      "folder_name": "folder_name",
      "is_open": true,
      "end_line": 0,
      "last_accessed_at": "2019-12-27T18:11:19.117Z",
      "start_line": 0,
      "visible_content": "visible_content"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}