List Files For Agent

agents.files.list(, ) -> SyncNextFilesPage[FileListResponse]

get/v1/agents/{agent_id}/files

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

ParametersExpand Collapse

agent_id: str

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

minLength42

maxLength42

after: Optional[str]

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

before: Optional[str]

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

Deprecatedcursor: Optional[str]

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

is_open: Optional[bool]

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

limit: Optional[int]

Maximum number of files to return

order: Optional[Literal["asc", "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[Literal["created_at"]]

Field to sort by

Accepts one of the following:

"created_at"

ReturnsExpand Collapse

class FileListResponse: …

Response model for agent file attachments showing file status in agent context

id: str

Unique identifier of the file-agent relationship

file_id: str

Unique identifier of the file

file_name: str

Name of the file

folder_id: str

Unique identifier of the folder/source

folder_name: str

Name of the folder/source

is_open: bool

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

end_line: Optional[int]

Ending line number if file was opened with line range

last_accessed_at: Optional[datetime]

Timestamp of last access by the agent

formatdate-time

start_line: Optional[int]

Starting line number if file was opened with line range

visible_content: Optional[str]

Portion of the file visible to the agent if open

List Files For Agent

from letta_client import Letta

client = Letta(
    api_key="My API Key",
)
page = client.agents.files.list(
    agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
)
page = page.files[0]
print(page.id)

{
  "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"
}