Revoke a browser Pass on its app
Revoke a browser Pass on its app. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1
Authentication: account_bearer. Required scope: browser_passes:write.
DELETE /account/bridge-apps/{app_id}/browser-passes/{pass_id}
Revoke a browser Pass on its app. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority.
| Parameter | Type | Description |
|---|---|---|
app_idpath · required | string | Required app_id path identifier. |
pass_idpath · required | string | Required pass_id path identifier. |
curl --fail-with-body -X DELETE "https://app.sym.so/v1/account/bridge-apps/$APP_ID/browser-passes/$PASS_ID" \
-H "Authorization: Bearer $SYM_ACCOUNT_API_KEY" \
-H "Content-Type: application/json" \
--data "{\"request_id\":\"11111111-1111-4111-8111-111111111111\",\"issued_at\":1800000000000}"{
"ok": true,
"deviceId": "11111111-1111-4111-8111-111111111111",
"result": {
"receipt": {
"id": "11111111-1111-4111-8111-111111111111",
"status": "completed",
"result": {
"revoked": true
}
},
"replayed": false
}
}Request schema
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"format": "uuid"
},
"issued_at": {
"type": "integer",
"description": "Unix milliseconds within 60 seconds. Example timestamp is illustrative; generate a fresh value."
}
},
"required": [
"request_id",
"issued_at"
],
"additionalProperties": false
}Authorization
{
"type": "account_bearer",
"scope": "browser_passes:write",
"transport": "Authorization: Bearer <account_api_key>",
"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
- Base URL: https://app.sym.so/v1 (not a workspace URL).
- App management is the access switch and browser Pass management, not desktop control.
- Management Off in the native app is a local veto. The app must be connected and support bridge-app-management-v2.
- No automatic retries: HTTP 200 alone is not mutation success. Check result.receipt.status; outcome_unknown requires receipts/state inspection.