appnz-agents-api

name	appnz-agents-api
description	Use this skill for app.nz cloud coding agents, Agent Studio automation, task creation, task traces, events, cancellation, retry, PR merge/sync/rollback, repo-config, and provider selection.

app.nz Agents 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/agents/config	Read public engine, model, provider, machine, skill, and default options.
POST	/api/agents/tasks	Create a coding-agent task for a repo and prompt.
GET	/api/agents/tasks	List caller tasks.
GET	/api/agents/tasks/{id}	Read normalized trace, status, PR, and artifacts.
GET	/api/agents/tasks/{id}/events	Poll task steps.
POST	/api/agents/tasks/{id}/messages	Send a follow-up instruction.
GET	/api/agents/repo-config?repo=...	Read repo automation config.
POST	/api/agents/repo-automation	Update repo automation settings.
GET	/api/public/tasks	Read public task feed.