---
title: Authentication — Reference
description: Bearer tokens for protected endpoints; no auth on free Discovery endpoints.
url: https://agentnumber.really.com/docs/reference/authentication
doc_version: "1.0.0"
last_updated: "2026-05-15"
---

> ## Documentation index
> Fetch the complete documentation index at: https://agentnumber.really.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Bearer tokens for protected endpoints; no auth required on the free Discovery endpoints.

## Bearer tokens

Every protected request carries:

```http
Authorization: Bearer <token>
```

Tokens are minted by:

- [`POST /subscribe`](/docs/reference/subscribe) — after a successful x402 / MPP payment
- [`POST /auth`](/docs/reference/auth) — after a successful wallet-signature recovery

## Bearer-gated endpoints

- [`POST /sms/send`](/docs/reference/send)
- [`GET /sms/receive`](/docs/reference/receive)
- [`GET /sms/messages`](/docs/reference/messages)
- [`GET /number`](/docs/reference/number)
- [`POST /voice/dial`](/docs/reference/voice-dial)
- [`GET /voice/presence/<phone>`](/docs/reference/voice-presence) (WS)
- [`GET /voice/stream/<call_id>`](/docs/reference/voice-stream) (WS)

## Public endpoints (no auth)

- [`GET /availability`](/docs/reference/availability)
- [`POST /waitlist`](/docs/reference/waitlist)
- [`POST /demo`](/docs/reference/demo)
- [`POST /auth/nonce`](/docs/reference/auth-nonce)
- [`POST /auth`](/docs/reference/auth) (signature replaces auth)

## Token rotation on recovery

A successful `POST /auth` revokes **every** existing token for the wallet, then issues a single fresh one. Multi-agent setups must re-auth in lockstep.

## What's NOT auth

- API keys, OAuth, JWT, session cookies — none of those.
- Headers other than `Authorization` — see [Payment](/docs/payment) for the `X-PAYMENT` header on subscribe.

## See also

- [Auth deep-dive](/docs/auth)
- [Recover a lost token](/docs/guides/recover-token)

## Sitemap

- [Overview](/docs/)
- [Quickstart](/docs/quickstart)
- [Authentication](/docs/auth)
- [SMS](/docs/sms)
- [Voice](/docs/voice)
- [MCP](/docs/mcp)
- [Payment](/docs/payment)

See the full [sitemap.md](/sitemap.md) for the complete index of docs pages.

---

← Previous: [Reference index](/docs/#api-reference) · Next: [Errors](/docs/reference/errors) →