---
title: "Revoke an API key"
method: DELETE
path: "/api/v1/keys/{key_id}"
---

# Revoke an API key

`DELETE /api/v1/keys/{key_id}`

## Request

- Base URL: `https://prowl.chat`
- URL: `https://prowl.chat/api/v1/keys/{key_id}`
- Auth: HTTP bearer

Takes effect immediately: the next call presenting this key fails authentication. Revoking the key behind an OAuth connector kills that connector too, without touching the OAuth grant.

## Path parameters

- `key_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `prowl_session` string, nullable

## Response `200`

Successful Response

- RevokedResponse: Revocation is immediate: the next call with this key fails authentication.
  - `success` boolean, required

## Other responses

- `401`: Missing, malformed or expired credential.
- `404`: No such key on this account, or already revoked.
- `422`: Validation Error

---

[API](https://skmtc.dev/prowl/apis/prowl-rest-api-v1.md) · [All operations](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/prowl/apis/prowl-rest-api-v1/revisions/897e8b30c330?raw)