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

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.

ParameterTypeDescription
agent_id
path · required
stringRequired agent_id path identifier.
chat_id
path · required
stringRequired chat_id path identifier.
attachment_id
path · required
stringRequired attachment_id path identifier.
X-Sym-Account-Authorization
header · required
stringBearer account key with browser_passes:delegate. Authorization separately carries the workspace key.
Request
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"
Response 200
{
  "ok": true
}

Request schema

Complete input schema
{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Authorization

Credential contract
{
  "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

StatusDescription
401Required account/workspace credential missing, wrong type, expired or revoked.
403Scope, matching account ownership or current target access denied.
404The resource is missing or intentionally hidden by authorization.
409App management disabled, app busy, stale state or conflicting request. Refresh state; do not blindly retry.
429The key exceeded its current rate limit.
503Control service, worker or device unavailable. A mutation may have an unknown outcome.

Usage notes