---
title: "Ban an agent by public key (admin only)."
method: POST
path: "/v1/admin/ban"
---

# Ban an agent by public key (admin only).

`POST /v1/admin/ban`

## Request

- Base URL: `https://api.lettera.dev`
- URL: `https://api.lettera.dev/v1/admin/ban`
- Auth: none declared. Required headers: `Authorization`

Requires Authorization: Bearer <ADMIN_TOKEN>. A banned agent cannot send, receive, or be resolved; its handle and three-word name stay bound to its key forever.

## Headers

- `Authorization` string, required

## Request body

- object
  - `pubkey` string, required: base58 of the 32-byte Ed25519 public key to ban

## Response `200`

agent banned

- object
  - `ok` boolean

## Other responses

- `401`: missing or wrong admin token
- `404`: no agent with that pubkey

---

[API](https://skmtc.dev/lettera/apis/lettera-relay-api.md) · [All operations](https://skmtc.dev/lettera/apis/lettera-relay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lettera/apis/lettera-relay-api/revisions/2d6d1e9b8ac5?raw)