appnz-assistant-api

name	appnz-assistant-api
description	Use this skill for app.nz assistant endpoints, assistant chats, messages, document extraction, speech transcription fallback, and browser call/WebSocket assistant flows.

app.nz Assistant 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/assistant	Assistant root/config surface.
GET	/api/assistant/chats	List assistant chats.
POST	/api/assistant/chats	Create or update assistant chat state.
POST	/api/assistant/transcribe	Transcribe recorded audio through the STT fallback chain.
POST	/api/documents/extract	Extract text from uploaded documents.
WS	/ws/assistant/call/{id}	Realtime assistant call channel.