---
title: "Confirm the magic link and receive the key"
method: POST
path: "/v1/keys/confirm"
tags: ["Keys"]
---

# Confirm the magic link and receive the key

`POST /v1/keys/confirm`

## Request

- Base URL: `https://api.farofinance.app`
- URL: `https://api.farofinance.app/v1/keys/confirm`
- Auth: none declared

Exchanges a valid magic-link token for a new API key. The key is returned **once** — store it now; only its hash is kept server-side.

## Request body

- KeyConfirmIn: Body for `POST /v1/keys/confirm` — the token from the magic link.
  - `token` string, required: The signed token from the emailed link.

## Response `200`

Successful Response

- KeyIssued: The newly issued key — returned once; only its hash is stored server-side.
  - `api_key` string, required: The full API key. Store it now; shown only once.
  - `key_prefix` string, required: A non-secret prefix for identifying the key later.
  - `email` string, required: The verified email the key was issued to.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/farofinance/apis/faro.md) · [All operations](https://skmtc.dev/farofinance/apis/faro/llms.txt) · [OpenAPI document](https://skmtc.dev/farofinance/apis/faro/revisions/205cdf54420b?raw)