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

Search accessible resources

Search accessible chats and messages without crossing Agent authorization boundaries.

API 2.7.0 · Published service contract ↗

Request

Base URL: https://app.sym.so/v1/workspaces/{workspace_id}

Authentication: bearer. Required scope: search:read.

GET /search

Search accessible chats and messages without crossing Agent authorization boundaries.

ParameterTypeDescription
q
query · required
stringSearch text containing at least two characters.
limit
query
1..100Maximum combined results; defaults to 50.
Request
curl --fail-with-body -X GET "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/search?q=$SYM_QUERY_Q_URLENCODED" \
  -H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"
Response 200
{
  "worker_id": "worker-example-001",
  "org_id": "workspace_example",
  "items": [
    {
      "type": "chat",
      "id": "chat_launch_report",
      "agent_id": "agent_example",
      "title": "Review launch report",
      "updated_at": 1785890040000
    }
  ],
  "count": 1,
  "ok": true
}

Authorization

Credential contract
{
  "type": "bearer",
  "scope": "search: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.