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

# Owner only

`POST /api/run/create_bot_key`

## Request

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

Owner only. Make a per-bot key (vk_...) that can only open sessions on the logins you name. Shown once; we store only its hash. Revoke any time with revoke_bot_key.

## Request body

- object
  - `label` string, required: Which bot, e.g. "invoice-bot".
  - `logins` string[], required: Names of saved logins this bot may use.

## 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)