---
title: "Revokes one of the account's keys from the console: an unconfirmed key the owner did not ask for, or any key they no longer use (review of #1339, M1 and M4). The account and its other keys are untouched."
method: POST
path: "/v1/console/keys/{key_id}/revoke"
tags: ["console"]
---

# Revokes one of the account's keys from the console: an unconfirmed key the owner did not ask for, or any key they no longer use (review of #1339, M1 and M4). The account and its other keys are untouched.

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

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/console/keys/{key_id}/revoke`
- Auth: none declared

## Path parameters

- `key_id` string, required

## Response `200`

The key is revoked

- ConsoleKeyActionResponse: Answer to a console key action.
  - `key_id` string, required: Key id the action applied to.
  - `state` string, required: The key's state afterwards: `verified` or `revoked`.

## Other responses

- `401`: Missing, unknown, revoked or expired session
- `404`: No live key with that id on this account
- `501`: Console not configured

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)