folders

List Folders

List all data folders created by a user.

get/v1/folders/

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/folders/
  • Auth
    HTTP bearer

Query parameters

beforestring nullable

Folder ID cursor for pagination. Returns folders that come before this folder ID in the specified sort order

afterstring nullable

Folder ID cursor for pagination. Returns folders that come after this folder ID in the specified sort order

limitinteger nullable

Maximum number of folders to return

order'asc' | 'desc'

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

order_by'created_at'

Field to sort by

namestring nullable

Folder name to filter by

Response

Successful Response

namestring required

The name of the folder.

descriptionstring nullable

The description of the folder.

instructionsstring nullable

Instructions for how to use the folder.

metadataobject nullable

Metadata associated with the folder.

idstring

The human-friendly ID of the Source

created_by_idstring nullable

The id of the user that made this Tool.

last_updated_by_idstring nullable

The id of the user that made this Tool.

created_atstring date-time nullable

The timestamp when the folder was created.

updated_atstring date-time nullable

The timestamp when the folder was last updated.

Example response

[
  {
    "id": "source-123e4567-e89b-12d3-a456-426614174000"
  }
]

Changes

No recorded changes to this operation across all 36 revisions of this API.