---
title: "Reset API key with one-time token"
method: POST
path: "/api/v1/api-keys/reset"
tags: ["General"]
---

# Reset API key with one-time token

`POST /api/v1/api-keys/reset`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/api-keys/reset`
- Auth: none required

Exchanges a one-time reset token (from email) for a fresh API key. Public endpoint — no Bearer auth required, the token authenticates the request.

## Request body

- object
  - `token` string, required: Single-use reset token from the reset email.

## Response `201`

Resource created.

- object
  - `api_key` object
    - `created_at` string
    - `id` string
    - `key` string
    - `key_prefix` string
    - `name` string
    - `status` string

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

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