appnz-codex-auth-api

name	appnz-codex-auth-api
description	Use this skill for app.nz Codex OAuth and connected Codex account management, including OAuth start/callback, listing linked accounts, deleting accounts, and gateway codex-account aliases.

app.nz Codex Auth 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/agents/codex-auth/start	Start Codex OAuth linking.
GET	/api/agents/codex-auth/callback	Handle OAuth callback.
POST	/api/agents/codex-auth/callback	Handle POST callback variant.
GET	/api/agents/codex-auth	List linked Codex accounts.
POST	/api/agents/codex-auth	Create/store linked Codex account metadata.
DELETE	/api/agents/codex-auth?id=...	Delete a linked Codex account.
GET	/api/gateway/codex-accounts	Gateway alias for linked Codex accounts.