Skip to content

Delete an identity (v2) - Legacy

Request

Deactivate an identity.

Deactivation is permanent and prevents further use in payments.

Historical versions remain available for audit.

Deactivation also releases the identity's match key, so a later POST /v2/identities with the same OrgId.Othr.Id or PrvtId.Othr.Id and identityType creates a new identity rather than adding a version.

Security
Bearer
Path
identity-idstringrequired

ID of the identity to deactivate.

Example:146f3c51-c313-47ce-b6f2-691c5a238b3e
curl -i -X DELETE \
  https://docs.ripple.com/_mock/products/payments-direct-2/v2025.11/api-docs/payments-direct-api/payments-direct-2-api/v2/identities/146f3c51-c313-47ce-b6f2-691c5a238b3e \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Identity deactivated.

Response
No content