Delete Principal

DELETE /{namespace}/{principalType}/{principalId}

Deletes a principal

Requires a signed user/session or the existing authenticated client flow. The anonymous DCR delegated device profile cannot invoke this operation.

Required scope

Any authenticated access token

namespacestringRequired: The namespace of the principal that the flow belongs to.
principalTypestringRequired: The type of principal that the flow belongs to.
principalIdstringRequired: The ID of the principal that the flow belongs to.

Principal deleted successfully

No response body.

500

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.