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.
| Parameter | Type | Description |
|---|---|---|
qquery · required | string | Search text containing at least two characters. |
limitquery | 1..100 | Maximum combined results; defaults to 50. |
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"{
"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
{
"type": "bearer",
"scope": "search: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. |