| name | appnz-builds-registries-api |
| description | Use this skill for app.nz build and registry APIs, including container/image registry management, build listing, build submission, build logs, and deployment artifact tracking. |
app.nz Builds and Registries 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 |
|---|
| GET | /api/registries | List container registries. |
| POST | /api/registries | Create or connect a registry. |
| GET | /api/builds | List builds. |
| POST | /api/builds | Create a build. |
| GET | /api/builds/{id} | Read build status and logs. |