Menu
Agach complete HTTP API reference: all REST endpoints, request/response types, WebSocket events, SSE, query parameters
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | doc-api-routes |
| description | Agach complete HTTP API reference: all REST endpoints, request/response types, WebSocket events, SSE, query parameters |
| user-invocable | true |
| disable-model-invocation | false |
All routes require JWT Bearer auth unless noted. Server runs on port 8322.
POST /api/projects — Create project
GET /api/projects — List projects (with summary)
GET /api/projects/{id} — Get project
GET /api/projects/{id}/info — Get project info (with breadcrumb, children)
GET /api/projects/{id}/summary — Get project task counts
GET /api/projects/{id}/children — List sub-projects
PATCH /api/projects/{id} — Update project
DELETE /api/projects/{id} — Delete project (cascades)
POST /api/projects/{id}/tasks — Create task
GET /api/projects/{id}/tasks — List tasks (?column=&assigned_role=&priority=&tag=&search=&limit=&offset=)
GET /api/projects/{id}/tasks/search — Search tasks (?q=&limit=)
GET /api/projects/{id}/tasks/{taskId} — Get task
GET /api/projects/{id}/board — Get board (columns with tasks)
GET /api/projects/{id}/columns — List columns
GET /api/projects/{id}/next-tasks — Get next available tasks (?count=&role=&feature_id=)
PATCH /api/projects/{id}/tasks/{taskId} — Update task
DELETE /api/projects/{id}/tasks/{taskId} — Delete task
POST /api/projects/{id}/tasks/{taskId}/move — Move task (body: target_column, reason)
POST /api/projects/{id}/tasks/{taskId}/move-to-project — Move to another project
POST /api/projects/{id}/tasks/{taskId}/reorder — Reorder task (body: position)
POST /api/projects/{id}/tasks/{taskId}/complete — Complete task (body: completion_summary, files_modified, tokens)
POST /api/projects/{id}/tasks/{taskId}/unblock — Unblock task
POST /api/projects/{id}/tasks/{taskId}/wont-do — Request won't-do
POST /api/projects/{id}/tasks/{taskId}/approve-wont-do — Approve won't-do
POST /api/projects/{id}/tasks/{taskId}/reject-wont-do — Reject won't-do
PATCH /api/projects/{id}/tasks/{taskId}/session — Update session ID
POST /api/projects/{id}/tasks/{taskId}/seen — Mark task as seen
POST /api/projects/{id}/tasks/{taskId}/comments — Create comment
GET /api/projects/{id}/tasks/{taskId}/comments — List comments (?limit=&offset=)
PATCH /api/projects/{id}/tasks/{taskId}/comments/{commentId} — Update comment
DELETE /api/projects/{id}/tasks/{taskId}/comments/{commentId} — Delete comment
GET /api/projects/{id}/tasks/{taskId}/dependencies — List dependencies
GET /api/projects/{id}/tasks/{taskId}/dependents — List dependents
POST /api/agents — Create global agent
GET /api/agents — List global agents
GET /api/agents/{slug} — Get agent by slug
PATCH /api/agents/{slug} — Update agent
DELETE /api/agents/{slug} — Delete agent
POST /api/agents/{slug}/clone — Clone agent (body: new_slug, new_name)
POST /api/agents/{slug}/specialized — Create specialized agent
GET /api/agents/{slug}/specialized — List specialized agents
GET /api/agents/{slug}/specialized/{specSlug} — Get specialized agent
PATCH /api/agents/{slug}/specialized/{specSlug} — Update specialized agent
DELETE /api/agents/{slug}/specialized/{specSlug} — Delete specialized agent
GET /api/agents/{slug}/specialized/{specSlug}/skills — List specialized agent skills
POST /api/projects/{projectId}/agents — Assign agent to project
GET /api/projects/{projectId}/agents — List project agents
GET /api/projects/{projectId}/agents/{slug}/tasks — List tasks by agent
DELETE /api/projects/{projectId}/agents/{slug} — Remove agent from project
POST /api/projects/{projectId}/agents/bulk-reassign — Bulk reassign tasks
POST /api/skills — Create skill
GET /api/skills — List skills
GET /api/skills/{slug} — Get skill
PATCH /api/skills/{slug} — Update skill
DELETE /api/skills/{slug} — Delete skill
POST /api/agents/{slug}/skills — Add skill to agent
GET /api/agents/{slug}/skills — List agent skills
DELETE /api/agents/{slug}/skills/{skillSlug} — Remove skill from agent
POST /api/projects/{id}/features — Create feature
GET /api/projects/{id}/features — List features (?status=)
GET /api/projects/{id}/features/{featureId} — Get feature
PATCH /api/projects/{id}/features/{featureId} — Update feature
PATCH /api/projects/{id}/features/{featureId}/status — Update feature status
DELETE /api/projects/{id}/features/{featureId} — Delete feature
GET /api/projects/{id}/stats/features — Get feature stats
POST /api/dockerfiles — Create dockerfile
GET /api/dockerfiles — List dockerfiles
GET /api/dockerfiles/{id} — Get dockerfile
PATCH /api/dockerfiles/{id} — Update dockerfile
DELETE /api/dockerfiles/{id} — Delete dockerfile
PUT /api/projects/{id}/dockerfile — Set project dockerfile
GET /api/projects/{id}/dockerfile — Get project dockerfile
DELETE /api/projects/{id}/dockerfile — Clear project dockerfile
POST /api/notifications — Create global/agent notification
GET /api/notifications — List all (?scope=&agent_slug=&unread=&limit=&offset=)
GET /api/notifications/unread-count — Global unread count
PUT /api/notifications/{id}/read — Mark as read
PUT /api/notifications/read-all — Mark all as read
DELETE /api/notifications/{id} — Delete notification
POST /api/projects/{id}/notifications — Create project notification
GET /api/projects/{id}/notifications — List project notifications
GET /api/projects/{id}/notifications/unread-count — Project unread count
PUT /api/projects/{id}/notifications/read-all — Mark all project as read
POST /api/projects/{projectId}/features/{featureId}/chats — Start session
GET /api/projects/{projectId}/features/{featureId}/chats — List sessions
GET /api/projects/{projectId}/features/{featureId}/chats/{sessionId} — Get session
POST /api/projects/{projectId}/features/{featureId}/chats/{sessionId}/end — End session
POST /api/projects/{projectId}/features/{featureId}/chats/{sessionId}/upload — Upload JSONL
GET /api/projects/{projectId}/features/{featureId}/chats/{sessionId}/download — Download JSONL
GET /api/projects/{id}/tool-usage — Tool usage stats
GET /api/projects/{id}/stats/timeline — Timeline (?days=60)
GET /api/projects/{id}/stats/cold-start — Cold start token stats
GET /api/projects/{id}/stats/model-tokens — Model token stats
GET /api/model-pricing — Model pricing list
POST /api/projects/{id}/images — Upload image (returns error)
GET /api/projects/{id}/images/{filename} — Serve image (returns error)
GET /api/projects/{id}/sse — Server-Sent Events stream
WS /ws — WebSocket (registered without auth middleware)
POST /api/auth/register, /api/auth/login, /api/auth/refresh, /api/auth/logout
GET /api/auth/me, PATCH /api/auth/me, POST /api/auth/me/password
GET /api/auth/sso/providers, /api/auth/sso/{provider}/authorize, /api/auth/sso/{provider}/callback
Task: task_created, task_updated, task_deleted, task_moved, task_completed
Project: project_created, project_updated, project_deleted
Comment: comment_added, comment_edited
Agent: agent_created, agent_updated, agent_deleted
Skill: skill_created, skill_updated, skill_deleted
Feature: feature_created, feature_updated, feature_status_updated, feature_deleted
Other: notification, wip_slot_available, wont_do_rejected, task_wont_do
Agach daemon agent: onboarding, WebSocket reconnect, Docker builds, chat sessions (Claude CLI), git worktrees, SQLite persistence
Agach identity system: authentication (JWT, bcrypt), SSO/OIDC, teams, users, nodes, daemon onboarding, token management
Agach shared infrastructure: internal/pkg (controller, middleware, websocket, sse, apierror), pkg (server types, client SDK, daemonws, domainerror), agachconfig
Agach project hexagonal architecture: bounded contexts, source code hierarchy, entry points, layers, and package structure
Agach business rules: blocking workflow, won't-do workflow, GetNextTask logic, resolution auto-append, priority system, comment system, features
Agach database schema: PostgreSQL tables for projects, roles, tasks, columns, comments, dependencies, features, skills, dockerfiles, notifications, chat sessions, specialized agents, nodes, onboarding