Delete Policy

​

DELETE /v1beta1/policies/

​

Path Parameters

​

Response

curl -X DELETE 'https://api.frontier.example.com/v1beta1/policies/550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​

Response Example

{}

​

Error Responses

​

Error Examples

{
  "error": {
    "code": "not_found",
    "message": "policy not found"
  }
}

{
  "error": {
    "code": "already_exists",
    "message": "conflict: policy cannot be deleted"
  }
}

​

Notes

• The policy ID must be a valid UUID
• Deleting a policy is permanent and cannot be undone
• Deleting a policy removes the role assignment from the principal on the resource
• An audit event (policy.deleted) is generated when a policy is successfully deleted
• Returns a 404 error if the policy doesn’t exist or the ID is invalid
• Returns a conflict error if the policy cannot be deleted due to system constraints