---
title: "Revoke Retriever API Key"
method: DELETE
path: "/v1/retrievers/{retriever_id}/api-keys/{key_id}"
tags: ["Retriever API Keys"]
---

# Revoke Retriever API Key

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

Revoke a retriever-scoped API key.

    **Effect:**
    - Key status is set to REVOKED
    - Key can no longer be used for authentication
    - Revocation is immediate (no grace period)
    - Auth cache is invalidated immediately
    - Cannot be undone (create a new key if needed)

    **Audit:**
    - Revocation is logged in the retriever's audit trail
    - Includes actor user ID and timestamp

## Path parameters

- `retriever_id` string, required
- `key_id` string, required

## Response `200`

Successful Response

- GenericSuccessResponse — GenericSuccessResponse.
  - `message` string
  - `success` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/23e05292e326/schema)