---
title: "Revoke Mine"
method: POST
path: "/v1/keys/{key_id}/revoke"
tags: ["keys"]
---

# Revoke Mine

`POST /v1/keys/{key_id}/revoke`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/keys/{key_id}/revoke`
- Auth: none required

Revoke a key the authenticated user owns. Sets ``status =
'revoked'`` so the auth middleware rejects future requests
presenting the key. Idempotent -- calling on an already-revoked
key returns 200.

404 ``KEY_NOT_FOUND`` when the id doesn't exist OR exists but is
attached to a different account (we never confirm a key id
belongs to someone else, to prevent enumeration).

## Path parameters

- `key_id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)