Doc api routes

Skill JLugagne/agach/.claude/skills/doc-api-routes

Agach orchestrates AI coding agents for your team. Define features through structured conversations. Agents execute the work in isolated environments, one task at a time, on your codebase.

Install

npx -y skills add JLugagne/agach --skill doc-api-routes

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Agach complete HTTP API reference: all REST endpoints, request/response types, WebSocket events, SSE, query parameters

SKILL.md

8.9 KB, ~2.1k tokens by cl100k_base, as published. Nobody here has run it

Agach HTTP API Reference

All routes require JWT Bearer auth unless noted. Server runs on port 8322.

Projects

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)

Tasks

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

Comments

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

Dependencies

GET    /api/projects/{id}/tasks/{taskId}/dependencies — List dependencies
GET    /api/projects/{id}/tasks/{taskId}/dependents   — List dependents

Agents (Roles)

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)

Specialized Agents

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

Project Agents

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

Skills

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

Features

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

Dockerfiles

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

Notifications

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

Chat Sessions

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

Statistics

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

Images (currently unavailable)

POST   /api/projects/{id}/images              — Upload image (returns error)
GET    /api/projects/{id}/images/{filename}   — Serve image (returns error)

Real-time

GET    /api/projects/{id}/sse                 — Server-Sent Events stream
WS     /ws                                    — WebSocket (registered without auth middleware)

Auth (see /doc-identity for full details)

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

WebSocket Event Types

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