Task Management API

Visit GitHub Repo

Test REST API

A simple yet robust Task Management API built with Django REST Framework and Celery...

Features

User authentication (JWT-based)
Create, read, update, and delete tasks
Searching and filtering of tasks
Task Rescheduling
Timezone-aware deadlines
Auto-completion of tasks via Celery
Email notifications for due and reminder
Telegram notifications for due and reminder

Technology Stack

Python 3.12.4
Django & DRF
Celery + Redis
PostgreSQL / MySQL
JWT Auth

Getting Started

Prerequisites

Python 3.12+
Redis
PostgreSQL

Installation

git clone https://github.com/carnage999-max/task-mgt-api.git

cd task-mgt-api
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
pip install -r requirements.txt
python manage.py migrate
celery -A project_name worker --loglevel=info
python manage.py runserver

API Usage

Authentication

POST /api/v1/users/login/

{
  "email": "user@example.com",
  "password": "secret"
}

Authorization Header

Authorization: Bearer <token>

Tasks Endpoints

Endpoint	Method	Description
/api/v1/task/tasks/	GET	List tasks
/api/v1/task/tasks/	POST	Create task
/api/v1/task/tasks/{id}/	GET	Retrieve task
/api/v1/task/tasks/{id}/	PUT	Update task
/api/v1/task/tasks/{id}/	DELETE	Delete task
/api/v1/task/tasks/{id}/mark_complete/	PATCH	Mark as complete

Create Task

POST /api/v1/task/tasks/

{
  "name": "Finish report",
  "description": "Weekly summary report",
  "deadline": "2025-06-01T15:00:00+01:00",
  "priority": "high"
}

Sample Response

{
  "id": 1,
  "name": "Finish Report",
  "status": "in_progress",
  ...
}

Retrieve Task

GET /api/v1/task/tasks/1/

Reschedule Task

PUT /api/v1/task/tasks/1/

{
  "deadline": "2026-06-01T15:00:00+01:00"
}

Key Implementation Details

Deadlines stored in UTC
Auto-complete with Celery
Email reminders

Future Improvements

Subtasks
OAuth login
Telegram/Discord webhook notifications

License

MIT

Contact

Ezekiel Okebule — jamesezekiel039@gmail.com

GitHub