API Online

Task Manager API

A fully-tested RESTful API built with Node.js & Express. Browse every endpoint below and click Try it to test GET routes live.

http://full-stack-assignment-seven-theta.vercel.app
9
Endpoints
3
Bugs Fixed
1
New Feature
80%+
Test Coverage
Read & Filter
GET /tasks

Return all tasks as a JSON array.

↗ Try it
GET /tasks?status=todo

Filter tasks by exact status. Valid values: todo, in_progress, done.

↗ Try it
GET /tasks?page=1&limit=10

Paginated task list. page is 1-indexed; limit controls page size.

↗ Try it
GET /tasks/stats

Returns count of tasks by status plus the number of overdue tasks.

↗ Try it
Create & Update
POST /tasks

Create a new task. title is required; all other fields are optional.

Request Body
{
  "title": "Finish the report",
  "description": "Q3 summary doc",
  "status": "todo",
  "priority": "high",
  "dueDate": "2025-12-31T00:00:00.000Z"
}
PUT /tasks/:id

Update any fields on an existing task. Returns the updated task or 404 if not found.

Request Body (any subset)
{
  "title": "Updated title",
  "priority": "low",
  "status": "in_progress"
}
Actions
PATCH /tasks/:id/complete

Mark a task as done and record completedAt. No body required. Returns 404 if task not found.

PATCH /tasks/:id/assign NEW

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.

Request Body
{
  "assignee": "Alice"
}
DELETE /tasks/:id

Permanently delete a task. Returns 204 No Content on success or 404 if not found.

Task Schema
Task Object
{
  "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"
}