Sign in

v36

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

List Agent Folders

Get the folders associated with an agent.

get/v1/agents/{agent_id}/folders

Path parameters

agent_idstring required

Query parameters

beforestring nullable

Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order

Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order

afterstring nullable

Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order

Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order

limitinteger nullable

Maximum number of sources to return

Maximum number of sources to return

order'asc' | 'desc'

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

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

order_by'created_at'

Field to sort by

Field to sort by

Response

Successful Response

namestring required

The name of the source.

descriptionstring nullable

The description of the source.

instructionsstring nullable

Instructions for how to use the source.

metadataobject nullable

Metadata associated with the source.

idstring

The human-friendly ID of the Source

vector_db_provider'native' | 'tpuf' | 'pinecone'

Supported vector database providers for archival memory

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 source was created.

updated_atstring date-time nullable

The timestamp when the source was last updated.

Example response

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