A fully-tested RESTful API built with Node.js & Express. Browse every endpoint below and click Try it to test GET routes live.
Filter tasks by exact status. Valid values: todo, in_progress, done.
Paginated task list. page is 1-indexed; limit controls page size.
Create a new task. title is required; all other fields are optional.
{
"title": "Finish the report",
"description": "Q3 summary doc",
"status": "todo",
"priority": "high",
"dueDate": "2025-12-31T00:00:00.000Z"
}
Update any fields on an existing task. Returns the updated task or 404 if not found.
{
"title": "Updated title",
"priority": "low",
"status": "in_progress"
}
Mark a task as done and record completedAt. No body required. Returns 404 if task not found.
Assign a person to a task. The assignee is trimmed and stored on the task object. Returns 400 for empty/missing assignee, 404 if task not found.
{
"assignee": "Alice"
}
Permanently delete a task. Returns 204 No Content on success or 404 if not found.
{
"id": "uuid-v4",
"title": "string (required)",
"description": "string (default: '')",
"status": "todo | in_progress | done (default: todo)",
"priority": "low | medium | high (default: medium)",
"dueDate": "ISO 8601 string | null",
"completedAt": "ISO 8601 string | null",
"assignee": "string | undefined",
"createdAt": "ISO 8601 string"
}