---
title: "Revoke scoped agent API key"
method: POST
path: "/v1/admin/agent-keys/{key_id}/revoke"
tags: ["Operations"]
---

# Revoke scoped agent API key

`POST /v1/admin/agent-keys/{key_id}/revoke`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/agent-keys/{key_id}/revoke`
- Auth: HTTP bearer

Revokes an agent API key. The raw key is never returned. Human AAL2 admin only; admin-agent keys cannot revoke agents or credentials.

## Path parameters

- `key_id` string, required

## Request body

- EmptyRequest

## Response `200`

RevokeAgentApiKeyResponse

- RevokeAgentApiKeyResponse
  - `status` 'revoked', required
  - `revoked_by` string, required
  - `key_id` string, required
  - `account_id` string, required

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)