Skip to main content
GET
/
agent
/
contexts
List agent contexts
curl --request GET \
  --url https://api.wacht.dev/agent/contexts \
  --cookie session_id=
{
  "status": 200,
  "message": "",
  "data": {
    "data": [
      {
        "id": "123456789012345678",
        "deployment_id": "111111111111111111",
        "context_group": "support-agents",
        "title": "Customer Support Conversation",
        "system_instructions": "You are a helpful customer support assistant.",
        "status": "active",
        "message_count": 15,
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-15T11:30:00Z"
      }
    ],
    "has_more": false,
    "limit": 10,
    "offset": 0
  },
  "session": {
    "id": "123456789012345678",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "errors": [
    {
      "code": "INVALID_CREDENTIALS",
      "message": "Invalid credentials. Please try again."
    }
  ]
}

Authorizations

​
session_id
string
cookie
required

Session-based authentication using cookies

Query Parameters

​
limit
integer
default:10

Maximum number of contexts to return

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of contexts to skip

Required range: x >= 0
​
status
enum<string>

Filter by status

Available options:
active,
archived,
all
​
search
string

Search term for context titles

Response

Contexts retrieved successfully

​
status
integer

HTTP status code

Example:

200

​
message
string

Response message (empty on success)

Example:

""

​
data
object
​
session
object

Minimal session info included in every response

​
errors
object[] | null

Error details (null on success)