Endpoint Index

Authentication

All endpoints require Authorization: Bearer <api_key> unless noted.

Identity

`GET /api/v1/me`

Returns authenticated user + API key metadata.

Billing

`GET /api/v1/balance`

Returns user token balance and saved billing readiness flags.

`GET /api/v1/token-packs`

Returns available token packages.

Templates

`GET /api/v1/templates`

List/search templates with filtering.

`GET /api/v1/templates/{templateId}`

Get full template detail including stored design JSON.

`GET /api/v1/templates/{templateId}/html`

Render printable HTML from template design.

Postcards

`POST /api/v1/postcards/send`

Send postcard batch using frontHtml and backHtml.

Admin

Admin endpoints require an API key created by an account listed in server admin allowlist.

`GET /api/v1/admin/token-packs`

Token package configuration.

`GET /api/v1/admin/users`

Search/list users with balances.

`GET /api/v1/admin/users/{userId}/token-balance`

Detailed balance + recent transactions for a user.