POSTPublic

Revoke an external identity

/api/v1/public/external-identity/{identity}/revoke

Requires X-Identity-Token. The identity must belong to the token email (404 otherwise, no leak). 409 IDENTITY_ALREADY_REVOKED if already revoked.

Path parameters

Field	Type	Description
identity Required	string	Path parameter `identity`.

Query parameters

This endpoint has no query parameters.

Request body

Field	Type	Description
reason	string	Optional revocation reason (max 500). e.g. "No longer needed"

Responses

Status	Meaning
200	Identity revoked
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/v1/public/external-identity/uuid_or_id/revoke' \
  -H 'Content-Type: application/json' \
  -d '{"reason":"No longer needed"}'

Response 200

json

{
  "status": "success",
  "message": "Identity revoked"
}