appnz-auth-account-api

name	appnz-auth-account-api
description	Use this skill for app.nz authentication and account APIs, including register, login, logout, Firebase sessions, password reset, /api/me preferences, OAuth authorize/token/userinfo, unsubscribe, and account bootstrap flows.

app.nz Auth and Account API

Use these app.nz control-plane APIs with Authorization: Bearer pk_live_.... Treat responses as JSON. Public config/list endpoints may work without auth, but write routes and user data routes require auth.

Workflow

1. Fetch the relevant config/list endpoint first when building UI or automation.
2. Send JSON bodies with Content-Type: application/json unless the endpoint specifies multipart upload.
3. Preserve returned IDs; follow-up routes are ID-based.
4. On errors, check status and JSON error; do not retry write calls blindly.

Endpoints

Method	Path	Use
POST	/api/register	Create an email/password account.
POST	/api/login	Create a session from email/password credentials.
POST	/api/firebase-session	Exchange Firebase auth for an app.nz session.
GET	/api/me	Read the current user account and preferences.
POST	/api/me/preferences	Update user preferences.
GET	/authorize	OAuth authorization endpoint.
POST	/token	OAuth token exchange endpoint.
GET	/userinfo	OAuth userinfo endpoint.