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

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.

ParameterTypeDescription
app_id
path · required
stringRequired app_id path identifier.
pass_id
path · required
stringRequired pass_id path identifier.
Request
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}"
Response 200
{
  "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

Complete input 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

Credential contract
{
  "type": "account_bearer",
  "scope": "browser_passes:write",
  "transport": "Authorization: Bearer <account_api_key>",
  "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