Task Manager API

API for managing users, tasks, and authentication in a productivity app.

POST

/auth/register

Authentication

Registers a new user with the provided email, password, and name.

Headers

Request Body

Request body for registering a new user

Responses

201

User registered successfully

400

Invalid input

POST

/auth/login

Authentication

Logs in an existing user with the provided email and password.

Headers

Request Body

Request body for logging in a user

Responses

200

Login successful

401

Unauthorized

GET

/users/me

Users

Retrieves the profile of the currently authenticated user.

Security

bearerAuth

Responses

200

User profile

401

Unauthorized

GET

/tasks

Tasks

Retrieves a list of tasks, with optional filtering by status and pagination.

Security

bearerAuth

Query Parameters

status
string

Filter tasks by status

limit
integer

Number of tasks to return

offset
integer

Pagination offset

Responses

200

List of tasks

401

Unauthorized

POST

/tasks

Tasks

Creates a new task with the provided title and optional description and due date.

Security

bearerAuth

Headers

Request Body

Request body for creating a new task

Responses

201

Task created

400

Invalid input

GET

/tasks/{taskId}

Tasks

Retrieves a specific task by its ID.

Security

bearerAuth

Path Parameters

taskId
string
required

The ID of the task to retrieve

Responses

200

Task details

404

Task not found

PATCH

/tasks/{taskId}

Tasks

Updates an existing task with the provided ID.

Security

bearerAuth

Headers

Path Parameters

taskId
string
required

The ID of the task to update

Request Body

Request body for updating a task

Responses

200

Task updated

400

Invalid input

404

Task not found

DELETE

/tasks/{taskId}

Tasks

Deletes a task with the specified ID.

Security

bearerAuth

Path Parameters

taskId
string
required

The ID of the task to delete

Responses

204

Task deleted

404

Task not found