Get latest chat messages
Return the bounded latest message tail for one authorized Agent chat in chronological order.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: messages:read.
GET /agents/{agent_id}/chats/{chat_id}/tail
Return the bounded latest message tail for one authorized Agent chat in chronological order.
| Parameter | Type | Description |
|---|---|---|
agent_idpath · required | string | Authorized Agent ID. |
chat_idpath · required | string | Accessible chat ID. |
limitquery | 1..20 | Latest message count; defaults to 5. |
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/chats/$CHAT_ID/tail" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"{
"worker_id": "worker-example-001",
"org_id": "workspace_example",
"agent_id": "agent_example",
"chat": {
"id": "chat_01J8",
"title": "Competitor research",
"status": "active",
"last_message_preview": "The report is ready."
},
"items": [
{
"id": "msg_01J8",
"role": "user",
"content": "Prepare the report.",
"status": "completed",
"created_at": "2026-08-06T14:17:00Z"
},
{
"id": "msg_01J9",
"role": "assistant",
"content": "The report is ready.",
"status": "completed",
"created_at": "2026-08-06T14:18:00Z"
}
],
"count": 2,
"ok": true
}Authorization
{
"type": "bearer",
"scope": "messages:read",
"transport": "Authorization: Bearer <workspace_api_key>"
}Errors
| Status | Description |
|---|---|
| 401 | The workspace API key is missing, invalid, expired, or revoked. |
| 403 | The key lacks the required scope or its owner no longer has permission. |
| 404 | The resource is missing or intentionally hidden by authorization. |
| 429 | The key exceeded its current rate limit. |