1. Docs
  2. API Reference
  3. Remove an identity

Remove an identity

DELETE/portal/v1/accounts/{accountSlug}/applications/{appSlug}/identities/{id}

Authentication

  • Bearer Token Authorization

    JWT access token

Path Parameters

Name Required Type Description
idRequiredstring

Code samples

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

Responses

204 Identity removed (assignments cascade deleted)
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 Application
POSTCreate an identity
GETList identities with their role assignments
GETGet Application identities summary
POSTBulk-create identities
POSTRecord a bulk-import wizard completion
GETGet an identity
PATCHUpdate an identity
GETGet identity detail with role assignments
POSTActivate an identity
POSTDeactivate an identity
GETGet identity's role assignments
GETGet identity's effective permissions