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",
      "attachments": [
        {
          "bytes": 182344,
          "content_type": "application/pdf",
          "expires_at": "2026-08-18T09:00:00Z",
          "has_thumb": true,
          "id": "9f1c0f0e-3d1a-4a4e-9b1e-4c1e2f3a4b5c",
          "name": "quarterly-report.pdf",
          "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
        }
      ],
      "chat_room_id": "daca00d0-eb6b-4db1-8201-c46015c93d04",
      "inserted_at": "2025-01-15T10:30:00Z",
      "metadata": {
        "delegation": {
          "hop": null,
          "message_id": "a1b2c3d4-e5f6-4a5b-9c8d-e7f8a9b0c1d2",
          "minted_at": "2026-07-11T10:30:00Z",
          "originator": {
            "display_name": "John Smith",
            "handle": "john.smith",
            "uuid": "550e8400-e29b-41d4-a716-446655440000"
          },
          "version": 1
        },
        "mentions": [
          {
            "handle": "data.analyst",
            "id": "1fa9c3d4-e5f6-4a5b-9c8d-e7f8a9b0c1d2",
            "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).

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

metaobjectOptional

Deprecated — use metadata instead

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error