API Reference

Overview of Mintea API routes. Detailed request/response schemas will be documented here over time — for workflows and auth, start with the guides.

Conventions

• Base path: /v1 (except GET /health)
• Auth: session cookie or Authorization: Bearer mtk_... — see Authentication
• Errors: { error: { code, message, details? } } — see Errors
• Credits: deducted after successful onchain confirmation — see Credits

Route map

Area	Endpoints
Health	GET /health
Auth	POST /v1/auth/register · login · logout · GET /v1/auth/me
API keys	POST · GET /v1/api-keys · DELETE /v1/api-keys/:id
Billing	GET /v1/billing/credits · POST /v1/billing/upgrade (always 403)
Collections	POST · GET /v1/collections · GET /v1/collections/:address
Collections (ops)	mint · mint-with-metadata · mint-batch · freeze/unfreeze · lock/unlock-transfers · pause/unpause
Collections (registry)	POST .../registry/approve · unapprove
Collections (metadata)	POST .../metadata/keys · POST .../metadata/:tokenId
Collections (state)	GET .../onchain

Sections

• Auth
• API Keys
• Billing
• Collections