---
title: "Revoke (soft-delete) an own API key"
method: DELETE
path: "/api/v1/api-keys/{key_id}"
tags: ["API Keys"]
---

# Revoke (soft-delete) an own API key

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

## Request

- Base URL: `https://api.hub-equity.com`
- URL: `https://api.hub-equity.com/api/v1/api-keys/{key_id}`
- Auth: HTTP bearer

Revokes one of your own API keys. Revocation is a soft-delete (`revoked_at` is set) and takes effect immediately — the key stops authenticating on the next request. Revoked keys remain visible via `include_revoked=true` for audit. Returns `409` if already revoked.

## Path parameters

- `key_id` string, uuid, required

## Response `204`

API key revoked

## Other responses

- `404`: API key not found or not owned by current user
- `409`: API key already revoked
- `422`: Validation Error

---

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