---
title: "Owner only"
method: POST
path: "/api/run/revoke_bot_key"
---

# Owner only

`POST /api/run/revoke_bot_key`

## Request

- Base URL: `https://vault.cloudforbots.com`
- URL: `https://vault.cloudforbots.com/api/run/revoke_bot_key`
- Auth: one of:
  - none
  - HTTP bearer

Owner only. Revoke a bot key right away and end every session it opened.

## Request body

- object
  - `bot_id` string, required

## Response `200`

Result with job, understood, outcome, usage

- object

## Other responses

- `401`: bad_agent_key
- `429`: free_limit_reached (includes upgrade link)

---

[API](https://skmtc.dev/cloudforbots/apis/login-vault.md) · [All operations](https://skmtc.dev/cloudforbots/apis/login-vault/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/login-vault/revisions/4b2f0405fb74?raw)