Skip to navigation
Platform APIPolicies

Delete policy

Delete a policy. A policy cannot be deleted while any project is assigned to it — reassign those projects first.

Authentication

AuthorizationBearer

Bearer authentication using API key. Generate an API key from the AI Guardrails Dashboard. Example: Bearer sk_123…

Keys carry one of two access scopes, chosen when the key is created:

  • Read and write — may call every endpoint. This is the default, and the scope of every key created before scopes were introduced.
  • Read only — may call read endpoints such as /v1-beta/logs, /v1-beta/analytics and the GET endpoints. Write endpoints return 403.

Issue a read-only key to anything that only needs to retrieve data, such as a log-shipping job or a dashboard, so that it cannot modify your policies or projects.

Path parameters

policyIdstringRequired

Response

Policy deleted
statusenumOptional
Response status
Allowed values:
messagestringOptional

Human-readable response message

idstringOptional
Policy ID

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error