| 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
- Fetch the relevant config/list endpoint first when building UI or automation.
- Send JSON bodies with
Content-Type: application/json unless the endpoint specifies multipart upload.
- Preserve returned IDs; follow-up routes are ID-based.
- 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. |
