SymDocs
Workspace API
All productsSym Workspace APISym Passes MCP
Supportjoinsym.com ↗
Sym Workspace API

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.

ParameterTypeDescription
agent_id
path · required
stringAuthorized Agent ID.
chat_id
path · required
stringAccessible chat ID.
limit
query
1..20Latest message count; defaults to 5.
Request
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"
Response 200
{
  "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

Credential contract
{
  "type": "bearer",
  "scope": "messages:read",
  "transport": "Authorization: Bearer <workspace_api_key>"
}

Errors

StatusDescription
401The workspace API key is missing, invalid, expired, or revoked.
403The key lacks the required scope or its owner no longer has permission.
404The resource is missing or intentionally hidden by authorization.
429The key exceeded its current rate limit.