---
title: "Revoke Ephemeral Key"
method: DELETE
path: "/api/v1/keys/ephemeral/revoke"
tags: ["API Keys"]
---

# Revoke Ephemeral Key

`DELETE /api/v1/keys/ephemeral/revoke`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/keys/ephemeral/revoke`
- Auth: none declared. Required headers: `X-API-Key`

Revoke current ephemeral key immediately.

**Authentication Required:** Include ephemeral key in `X-API-Key` header.

**Use Cases:**
- User explicitly requests key deletion
- Security: User suspects key compromise
- Privacy: User wants to clear session data

**Note:** Keys auto-expire after 24 hours, so manual revocation is optional.

## Headers

- `X-API-Key` string, required

## Response `200`

Key revoked successfully or not found

- RevokeKeyResponse: Response model for key revocation.
  - `message` string, required: Status message
  - `revoked` boolean, required: Whether key was successfully revoked

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)
