Agent Contexts / List
List Agent Contexts
Retrieve all agent contexts for an external user. Returns context metadata including creation dates, memory types, and agent IDs. Use this endpoint to display conversation histories, manage active sessions, or clean up stale contexts.
GET
{baseAPIUrl}/agent-contextsAuthentication
Required. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | Application identifier |
| externalUserId | string | Required | External user identifier |
| agentId | string | Optional | Filter by agent ID |
| memoryType | string | Optional | Filter by memory type |
| limit | number | Optional | Results per page (1-100, default: 20) |
| offset | number | Optional | Number of results to skip (default: 0) |
Response
| Field | Type | Description |
|---|---|---|
| items | array | Array of agent context objects |
| total | number | Total number of matching contexts |
| limit | number | Current page size |
| offset | number | Current offset |
Try It
Query Parameters
Application identifier
External user identifier
Filter by agent ID
Filter by memory type
Results per page (1-100, default: 20)
Number of results to skip (default: 0)