---
title: "Revoke a router key"
method: DELETE
path: "/v1/agents/{agent_id}/router-keys/{key_id}"
tags: ["Agents"]
---

# Revoke a router key

`DELETE /v1/agents/{agent_id}/router-keys/{key_id}`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/{agent_id}/router-keys/{key_id}`
- Auth: HTTP bearer

Revokes the key. The gateway stops accepting it within 60 s (router-key tokens
live at most that long and the gateway re-exchanges on expiry). Idempotent.
Human users only.

## Path parameters

- `agent_id` string, uuid, required
- `key_id` string, uuid, required

## Response `200`

Revoked

- RouterKey
  - `id` string, uuid, required
  - `agent_id` string, uuid, required
  - `name` string, required
  - `key_prefix` string, required: First 20 characters (`sk-shroud-v1-` + 7) — enough to recognise, not to use
  - `max_concurrent_streams` integer, nullable
  - `spend_cap_usd` number, nullable
  - `created_at` string, date-time, required
  - `last_used_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable

## Other responses

- `403`: Insufficient permissions
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)