appnz-observability-api

name	appnz-observability-api
description	Use this skill for app.nz platform health and diagnostics, including /api/selftest, /api/platform/status, browser/backend error reporting, admin spend checks, and verifying route readiness.

app.nz Observability 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
GET	/api/selftest	Run platform self-tests, optionally scoped by page.
GET	/api/platform/status	Read product/module status used by the status UI.
POST	/api/errors/js	Submit browser JavaScript error reports.
POST	/api/errors/backend	Submit backend error reports.
GET	/api/admin/spend	Admin spend overview.