Delete a policy
DELETE/v1/policies/:id
Only a policy with no plans can be deleted. Retire one that has plans instead.
Operator only: needs a system-scoped token.
Request
Responses
- 204
- 401
- 403
- 404
- 409
- default
No Content
Unauthorized.
unauthenticated: The token is missing, expired or not valid.
Forbidden.
forbidden: The token lacks the policy:write permission.
Not Found.
not_found: The id is not a UUID, or no policy has it.
Conflict.
conflict: A plan names the policy, counting deleted plans still inside their purge grace. Retire the policy instead.
An error, as an RFC 7807 problem document.