Get recent workspace activity
Return a bounded snapshot of the most recent chats for every Agent the current key owner can access, optionally including the latest normalized messages.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: chats:read.
GET /activity/recent
Return a bounded snapshot of the most recent chats for every Agent the current key owner can access, optionally including the latest normalized messages.
| Parameter | Type | Description |
|---|---|---|
per_agentquery | 1..5 | Maximum recent chats per authorized Agent; defaults to 3. |
message_limitquery | 0..3 | Maximum latest messages per returned chat; defaults to 2. |
include_messagesquery | boolean | Include bounded message content; defaults true and additionally requires messages:read. |
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/activity/recent" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"{
"worker_id": "worker-example-001",
"org_id": "workspace_example",
"workspace": {
"id": "workspace_example"
},
"generated_at": "2026-08-06T14:20:00Z",
"agents": [
{
"agent": {
"id": "agent_example",
"name": "Example Agent",
"status": "active"
},
"recent_chats": [
{
"id": "chat_01J8",
"title": "Competitor research",
"status": "active",
"unread_count": 1,
"current_message_status": "completed",
"active_tool_name": "",
"last_activity_at": "2026-08-06T14:18:00Z",
"last_message_preview": "The report is ready.",
"messages": [
{
"id": "msg_01J9",
"role": "assistant",
"content": "The report is ready.",
"status": "completed",
"created_at": "2026-08-06T14:18:00Z"
}
]
}
]
}
],
"totals": {
"authorized_agents": 1,
"returned_chats": 1,
"unread_chats": 1,
"responding_chats": 0
},
"ok": true
}Authorization
{
"type": "bearer",
"scope": "chats: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. |
| 429 | The key exceeded its current rate limit. |
Usage notes
- Only currently authorized Agents are represented.
- Message content is bounded to prevent unbounded workspace dumps.