Skip to main content

​
List Tasks

GET /api/projects/:projectId/tasks
Returns all tasks for a project, ordered by priority and creation date.

​
Get Task

GET /api/projects/:projectId/tasks/:id
Returns full task details including description, logs, and usage stats.

​
Get Task Detail

GET /api/projects/:projectId/tasks/:id/detail
Extended detail view with revision history, attachments, and complete log entries.

​
Create Task

POST /api/projects/:projectId/tasks
Content-Type: application/json

{
  "title": "Add user authentication",
  "description": "Implement JWT-based login and registration",
  "type": "feature",
  "priority": 2,
  "model": "sonnet",
  "thinkingEffort": "medium"
}
FieldRequiredDefaultDescription
titleYes—Task title
descriptionNo—Detailed instructions
typeNofeaturefeature, bugfix, refactor, docs, test, chore
priorityNo10 (low) to 3 (urgent)
modelNosonnetopus, sonnet, haiku
thinkingEffortNomediumlow, medium, high

​
Update Task

PUT /api/projects/:projectId/tasks/:id
Content-Type: application/json

​
Change Status

PUT /api/projects/:projectId/tasks/:id/status
Content-Type: application/json

{ "status": "in_progress" }
Moving to in_progress spawns a Claude agent. Moving to done stops any running agent.

​
Stop Agent

POST /api/projects/:projectId/tasks/:id/stop
Stops the running Claude agent without changing the task status.

​
Restart Agent

POST /api/projects/:projectId/tasks/:id/restart
Kills the current agent and starts a fresh session.

​
Request Changes

POST /api/projects/:projectId/tasks/:id/request-changes
Content-Type: application/json

{ "feedback": "Add input validation to the login endpoint" }
Moves the task back to in_progress with feedback appended to the prompt.

​
Get Logs

GET /api/projects/:projectId/tasks/:id/logs
Returns all terminal log entries for the task.

​
Delete Task

DELETE /api/projects/:projectId/tasks/:id