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_... / mts_... — see Authentication
Errors: { error: { code, message, details? } } — see Errors
Credits: deducted after successful onchain confirmation; sandbox keys skip the meter — see Credits and Sandbox

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`
Chains	`GET /v1/chains`
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`
IPFS	`POST /v1/ipfs/pin` · `GET /v1/ipfs/files`