AgentConnect
Sessions

Get a thread's messages

Proxies a page of one thread's record live from a daemon holding the session that received its root, rootId (a Slack ts or a webchat postId): the root, then the thread's messages oldest first, from people and agents, the holding task's turns, and observations nobody addressed to an agent; the reading session's own turns stay in its main timeline. Paged like getSessionMessages (cursor back, after forward), and summary is the thread's footer. Whoever may view the session may read an unowned thread; a thread a task holds is read only by who may view that task's session, and anyone else gets its footer without excerpts or title (readable: false) and no messages. 404 when the session never received that root, or the id names a reply. 409 DAEMON_FEATURE_MISSING when its daemon cannot serve thread reads; 503 when none is reachable. Nothing is stored by this call.

GET
/v1/orgs/{orgId}/sessions/{id}/threads/{rootId}/messages

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string
rootId*string
Length1 <= length <= 200

Query Parameters

cursor?string
after?string
Match^\d+$
limit?integer
Range0 < value <= 200

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/sessions/string/threads/string/messages"
{  "sessionId": "string",  "rootId": "string",  "messages": [    {      "seq": 0,      "sender": "string",      "senderName": "string",      "senderAvatarUrl": "http://example.com",      "trustedAgentBot": true,      "ts": "string",      "eventTimeUs": 0,      "postId": "string",      "kind": "string",      "text": "string",      "attachments": [        {          "name": "string",          "mimeType": "image/png",          "data": "string"        }      ],      "sharedImage": {        "attachment": {          "name": "string",          "mimeType": "image/png",          "data": "string",          "width": 1,          "height": 1        },        "original": {          "kind": "inline"        },        "revision": 0      },      "toolCallId": "string",      "toolStatus": "string",      "toolKind": "string",      "body": "string",      "bodyTruncated": true,      "bodyBytes": 0,      "thread": "string",      "handedTo": "string"    }  ],  "nextCursor": "string",  "liveCursor": "string",  "liveMore": true,  "summary": {    "rootId": "string",    "rootExcerpt": "string",    "replies": 0,    "lastReplyAt": "string",    "lastReply": {      "sender": "string",      "senderName": "string",      "excerpt": "string"    },    "participants": [      {        "sender": "string",        "senderName": "string"      }    ],    "task": {      "sessionId": "string",      "title": "string",      "state": "open",      "starting": true    },    "running": true,    "readable": true  }}