/{app_slug}/v1/auth/request-verificationAuthMint a contact-verification code (PAK-required)
Mints a fresh 6-digit verification code bound to the email or phone contact named in the body. Body must contain exactly one of `email` / `phone`. PAK-required — `Authorization: Bearer <pcft_live_*>` carrying `auth.user.verify.create` narrowed to this app's URN. Public mint flows are refused with 401 — any anonymous mint endpoint is a spam-forwarder vector. Returns `{ code, expires_at }` for delivery via the customer's own SMTP / SMS provider. Returns `{}` (no code) when the contact doesn't match an account in this app or is already verified — uniform shape prevents enumeration. Issuing a code invalidates any previously issued, unconsumed code for the same contact — including the one auto-emailed at signup. Only the most recently minted code is accepted.
Path parameters
app_slug*stringSlug of the app.
Request body
emailstringEmail contact value to target. Set this OR `phone`, not both.
Example: "jane@example.com"
phonestringPhone contact value (any format the customer normalised; recommended E.164). Set this OR `email`, not both.
Example: "+15551234567"
Response · 201 `{ code, expires_at }` when the contact exists and is unverified; `{}` otherwise.
code*stringPlaintext 6-digit code. Returned when the contact matches an EndUser in this app and the precondition is satisfied (contact unverified, for verification; contact verified, for reset). Otherwise the response is `{}` (no code) — same shape on both branches to prevent enumeration.
Example: "123456"
expires_at*stringCode expiry, ISO 8601. Codes live for 10 minutes.
Example: "2026-05-09T17:30:00.000Z"
Example
Request
POST https://api.auth.productcraft.co/{app_slug}/v1/auth/request-verification
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"email": "jane@example.com",
"phone": "+15551234567"
}Response
{
"code": "123456",
"expires_at": "2026-05-09T17:30:00.000Z"
}