# Identity Mint — Server-Side UUIDv4/v5 + Handle Generation

> Identity Mint — Server-Side UUIDv4/v5 + Handle Generation is a paid API for AI agents from agent402.tools, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Mints a random UUIDv4 user-id, derives a deterministic UUIDv5 correlation-id from an email, and slugifies a display name into a URL-safe handle in one round-trip

## Facts

- Endpoint: POST https://agent402.tools/api/skill/identity-mint
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/identity-mint-server-side-uuidv4-v5-handle-generation-5ddf012b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vcrwTOG9iOjRk_SXuCtmY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability identity-mint-server-side-uuidv4-v5-handle-generation-5ddf012b -d '<json body>'
```

Example prompt: Mint a new server-side identity for user 'Jane Doe' with email jane.doe@example.com — generate a random UUID for them, derive a deterministic correlation ID from their email, and produce a URL-safe handle, signing with my secret 'supersecrethmac42'.

## When to prefer this

Use this endpoint when you need to atomically provision a new user identity in a single server-side call — specifically when you need all three artifacts (random UUID, deterministic correlation UUID from email, URL-safe handle) plus a signed JWT in one round-trip, rather than calling separate UUID, slug, and JWT libraries or endpoints individually.

## Known failure modes

- Missing required fields (email, displayName, signingSecret) returns a 4xx validation error
- Invalid or malformed email may result in a non-deterministic or error UUIDv5
- Insufficient payment (x402 protocol) results in a 402 Payment Required response
- Malformed signingSecret may produce an invalid JWT or error response

## How this service works

Bundled execution of the Server-side identity mint workflow - The server-side identity-issuance round-trip: mint a random user-id (UUIDv4), derive a deterministic cross-system correlation-id (UUIDv5), turn the display name into a URL-safe handle, ...

## Output

Returns a bundled identity object containing: a random UUIDv4 as the user-id, a deterministic UUIDv5 correlation-id derived from the email, a URL-safe slugified handle derived from the display name, and a signed JWT using the provided HMAC secret.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "email": {
   "type": "string",
   "description": "the user's email (used to derive the deterministic UUIDv5 correlation ID)"
  },
  "displayName": {
   "type": "string",
   "description": "the user's display name (will be slugified for the URL handle)"
  },
  "signingSecret": {
   "type": "string",
   "description": "the server's JWT HMAC signing secret"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "args": {
   "email": "alice.oconnor@example.com",
   "displayName": "Alice O'Connor",
   "signingSecret": "server_demo_jwt_secret_do_not_use_in_prod"
  },
  "pack": "identity-mint",
  "steps": [
   {
    "ok": true,
    "slug": "uuid",
    "result": {}
   },
   {
    "ok": true,
    "slug": "uuid-v5",
    "result": {}
   },
   {
    "ok": true,
    "slug": "slugify",
    "result": {}
   },
   {
    "ok": true,
    "slug": "password",
    "result": {}
   },
   {
    "ok": true,
    "slug": "hash",
    "result": {}
   },
   {
    "ok": true,
    "slug": "jwt-sign",
    "result": {}
   },
   {
    "ok": true,
    "slug": "base64",
    "result": {}
   }
  ],
  "summary": "7/7 steps succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/identity-mint-server-side-uuidv4-v5-handle-generation-5ddf012b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)