---
title: "Delete Permission"
method: DELETE
path: "/internal/permissions/{permission_id}"
tags: ["internal"]
---

# Delete Permission

`DELETE /internal/permissions/{permission_id}`

Delete a permission.

Refuses (409) if any role still grants it, returning the list of roles so the
caller can prompt the user to remove it from those roles first. Pass
``force=true`` to first clear the permission from every role that grants it
and then delete it, all in one transaction.

## Path parameters

- `permission_id` string, uuid, required

## Query parameters

- `force` boolean

## Response `200`

Successful Response

- DeletePermissionResponse
  - `permission_id` string, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/425d5b8a3c17/schema)