Detach conversation browser Pass
Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: dual_bearer. Required scope: browser_passes:write.
DELETE /agents/{agent_id}/chats/{chat_id}/browser-passes/{attachment_id}
Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions.
| Parameter | Type | Description |
|---|---|---|
agent_idpath · required | string | Required agent_id path identifier. |
chat_idpath · required | string | Required chat_id path identifier. |
attachment_idpath · required | string | Required attachment_id path identifier. |
X-Sym-Account-Authorizationheader · required | string | Bearer account key with browser_passes:delegate. Authorization separately carries the workspace key. |
curl --fail-with-body -X DELETE "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/agents/$AGENT_ID/chats/$CHAT_ID/browser-passes/$ATTACHMENT_ID" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY" \
-H "X-Sym-Account-Authorization: Bearer $SYM_ACCOUNT_API_KEY"{
"ok": true
}Request schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Authorization
{
"type": "dual_bearer",
"scope": "browser_passes:write",
"workspace_scopes": [
"workspace:read",
"browser_passes:write"
],
"account_scopes": [
"browser_passes:delegate"
],
"transport": "Authorization: Bearer <workspace_api_key>; X-Sym-Account-Authorization: Bearer <account_api_key>",
"same_owner_required": true,
"workspace_key_compatible": false
}Errors
| Status | Description |
|---|---|
| 401 | Required account/workspace credential missing, wrong type, expired or revoked. |
| 403 | Scope, matching account ownership or current target access denied. |
| 404 | The resource is missing or intentionally hidden by authorization. |
| 409 | App management disabled, app busy, stale state or conflicting request. Refresh state; do not blindly retry. |
| 429 | The key exceeded its current rate limit. |
| 503 | Control service, worker or device unavailable. A mutation may have an unknown outcome. |
Usage notes
- Workspace key additionally requires workspace:read. Account key requires browser_passes:delegate. Neither credential alone is sufficient.
- Read/full permission cannot exceed the underlying Pass. Detach revokes only this conversation; already-dispatched actions may finish.
- Grants expire after 30 days. Reattaching creates a new generation; stale handles must not revive.
- To use attached Passes, send a message with both credentials. Ordinary workspace-only messages gain no personal browser authority.