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

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.

ParameterTypeDescription
per_agent
query
1..5Maximum recent chats per authorized Agent; defaults to 3.
message_limit
query
0..3Maximum latest messages per returned chat; defaults to 2.
include_messages
query
booleanInclude bounded message content; defaults true and additionally requires messages:read.
Request
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/activity/recent" \
  -H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"
Response 200
{
  "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

Credential contract
{
  "type": "bearer",
  "scope": "chats: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.
429The key exceeded its current rate limit.

Usage notes