---
title: "Principal Signup Complete"
method: POST
path: "/v1/auth/principal/signup/complete"
tags: ["auth"]
---

# Principal Signup Complete

`POST /v1/auth/principal/signup/complete`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/auth/principal/signup/complete`
- Auth: none declared

Provision a principal and one hosted agent, then sign them in.

Idempotent against an address that already has an account: it signs them
in rather than failing. `principals.email` is UNIQUE, so the alternative
is a 409 that tells an attacker the address is registered -- and a real
person who signed up twice deserves to land in the console either way.

## Request body

- PrincipalSignupComplete
  - `token` string, required
  - `display_name` string, required
  - `accept_aup_version` string, required
  - `accept_tos_version` string, required
  - `source` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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