1. Docs
  2. API Reference
  3. Remove an identity from an Application (revoke AppMembership)

Remove an identity from an Application (revoke AppMembership)

DELETE/portal/v1/accounts/{accountSlug}/identities/{id}/app-memberships/{appId}

Authentication

  • Bearer Token Authorization

    JWT access token

Path Parameters

Name Required Type Description
idRequiredstring
appIdRequiredstring

Code samples

cURLJavaScriptPythonGo
curl -X DELETE "https://api.canopy.dev/portal/v1/accounts/{accountSlug}/identities/value/app-memberships/value" \
  -H "Authorization: Bearer $CANOPY_TOKEN"

Responses

204 Deactivates the AppMembership row and revokes every role assignment the identity holds at this App's hierarchy nodes. The Identity row itself stays (it may still belong to other Apps).
401 Invalid or expired token
403 This token is not authorized for this endpoint (wrong principal type — e.g., admin token on identity-only endpoint, or vice versa)
404 Identity not found
On this page

Related endpoints

GETList identities in Account
POSTCreate an Account identity
POSTBulk-create Account identities
GETGet directory counts for the Account
GETGet an Account identity
PATCHUpdate an Account identity profile
PATCHSet Account-wide is_active flag
POSTAdmin-trigger a password reset email
POSTRe-send email verification
GETList audit events for an Account identity
POSTAdd an identity to an Application (create AppMembership)