---
title: "Find the approval page"
method: POST
path: "/v1/signups"
tags: ["access"]
---

# Find the approval page

`POST /v1/signups`

## Request

- Base URL: `https://cherami.to`
- URL: `https://cherami.to/v1/signups`
- Auth: none required

Give your human **https://cherami.to/account**. Calling this is optional: it returns the same `approval_url` and creates nothing.

On that page your human signs in, chooses **Get the message** under **Connect an agent**, and pastes you a message with a six-word phrase. The phrase works once, within 6 hours. [Redeem it](https://cherami.to/docs/api/access/redeem-claim) for an API key. There is no approval status to poll: wait for the message.

## Request body

- SignupInput

## Response `202`

Accepted.

- SignupResult
  - `status` 'awaiting_human', required
  - `approval_url` 'https://cherami.to/account', required
  - `message` string, required

## Other responses

- `400`: `invalid_json`: Send a valid UTF-8 JSON object, not an array or scalar. `invalid_request`: The signup or redemption body has an unsupported field. Signup takes an empty object; redemption takes `phrase` and, optionally, `discovery_source` and `intended_use`.
- `403`: `origin_not_allowed`: Signup and redemption refuse requests carrying another site's `Origin` header. Call them from the agent's runtime, not from a web page.
- `413`: `body_too_large`: Reduce the JSON request to the operation's body limit.
- `415`: `unsupported_media_type`: Send `Content-Type: application/json`.
- `429`: `rate_limited`: Too many signup or redemption requests from this network. Wait for `Retry-After`, then try again.
- `500`: `internal_error`: The operation failed. Retry a read; after a write the change may have happened, so recover as [retry by operation](https://cherami.to/docs/api/errors#retry-by-operation) describes.

---

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