---
title: "Create Token"
method: POST
path: "/auth/tokens"
tags: ["auth"]
---

# Create Token

`POST /auth/tokens`

Mint a personal access token (``nano_u_v1_`` PAT). The raw value is returned
exactly once. User credentials only, holding conglomerate scope (Spec 2 §7).

## Request body

- CreateTokenRequest
  - `name` string, nullable
  - `expires_in_seconds` integer, nullable

## Response `201`

Successful Response

- CreateTokenResponse — The raw ``token`` is surfaced exactly once, at creation.
  - `id` string, required
  - `token` string, required
  - `name` string, nullable
  - `key_prefix` string, required
  - `kind` string, required
  - `expires_at` string, nullable
  - `created_at` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) · [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nanocorp/nanocorp-api/revisions/04b208d3215b/schema)