# Delete an access policy

Canonical page: https://docs.ovok.com/api/access-policies/delete-an-access-policy

`DELETE /v1/access-policies/{id}`

Deletes an access policy, and its copies in child projects with it. This cannot be undone.

**Scope:** the caller's project (from the token).

## Behaviour

- A policy that a member holds, or that a project setting such as `DEFAULT_PATIENT_ACCESS_POLICY` names, is refused with `POLICY_IN_USE`. The error says which: `heldByMembers` and `settings`.
- Ovok's own policies and copies of a parent project's policies are refused with `POLICY_READ_ONLY`.

## Example

```bash
curl -X DELETE 'https://api.sandbox.ovok.com/v1/access-policies/POLICY_ID' -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```

**Who can call it:** a project admin. See [roles](/access-policies#who-can-call-a-route).