Get agent context for rehydration

{
  "data": [
    {
      "content": "@DataAnalyst please analyze the Q4 sales data",
      "id": "a1b2c3d4-e5f6-4a5b-9c8d-e7f8a9b0c1d2",
      "message_type": "text",
      "sender_id": "550e8400-e29b-41d4-a716-446655440000",
      "sender_type": "User",
      "chat_room_id": "daca00d0-eb6b-4db1-8201-c46015c93d04",
      "inserted_at": "2025-01-15T10:30:00Z",
      "metadata": {
        "mentions": [
          {
            "handle": "data.analyst",
            "id": "uuid",
            "name": "DataAnalyst"
          }
        ]
      },
      "sender_name": "John Smith",
      "updated_at": "2025-01-15T10:30:00Z"
    }
  ],
  "metadata": {
    "has_more": true,
    "limit": 1,
    "next_cursor": "string",
    "page": 1,
    "page_size": 1,
    "total_count": 1,
    "total_pages": 1
  },
  "meta": {
    "has_more": true,
    "limit": 1,
    "next_cursor": "string",
    "page": 1,
    "page_size": 1,
    "total_count": 1,
    "total_pages": 1
  }
}

Returns all messages relevant to the agent for execution context/rehydration.

This includes:

All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.)
All text messages that @mention the agent

Use this endpoint to load the complete context an external agent needs to resume execution.

Messages are returned in chronological order (oldest first).

Pagination

Use cursor + limit for cursor-based pagination (recommended). The response metadata includes next_cursor and has_more.

page and page_size are deprecated and will be removed in API 2.0.0 (2026-10-01).

Returns all messages relevant to the agent for execution context/rehydration. This includes: - All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.) - All text messages that @mention the agent Use this endpoint to load the complete context an external agent needs to resume execution. Messages are returned in chronological order (oldest first). ## Pagination Use `cursor` + `limit` for cursor-based pagination (recommended). The response `metadata` includes `next_cursor` and `has_more`. `page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).

Authentication

X-API-Keystring

Enter your API key for programmatic access

Path parameters

chat_idstringRequiredformat: "uuid"

Chat Room ID

Query parameters

cursorstringOptional

Cursor for keyset pagination (from previous response next_cursor)

limitintegerOptional1-100

Items per page for cursor pagination (default: 50, max: 100)

pageintegerOptionalDeprecated

Page number (deprecated — use cursor instead)

page_sizeintegerOptionalDeprecated

Items per page (deprecated — use limit instead)

Response

Agent context

datalist of objects

metadataobject

metaobject

Deprecated — use metadata instead

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -G https://app.band.ai/api/v1/agent/chats/chat_id/context \
>	-H "X-API-Key: <apiKey>" \
>	-d limit=50 \
>	-d page=1 \
>	-d page_size=50