API Documentation — TaskMaster Pro

Authentication

Alle API-Anfragen erfordern einen API-Schlüssel, der über den X-API-Key Header gesendet wird.

curl -H "X-API-Key: YOUR_API_KEY" \
  https://todo.moddy-blossom.at/api/v1/tasks

Erstelle deinen API-Schlüssel in Einstellungen → API-Schlüssel.

Rate Limits

60 Anfragen pro Minute pro API-Schlüssel. Überschreitung führt zu 429 Too Many Requests.

Endpoints

methode	Endpoint	Description	Parameter
GET	`/api/v1/tasks`	List tasks	Query: status, team_id, assigned_to_id, page, per_page
GET	`/api/v1/tasks/:id`	Get a task
POST	`/api/v1/tasks`	Create a task	Body: title (required), description, due_date, team_id, assigned_to_id, status, is_private
PATCH	`/api/v1/tasks/:id`	Update a task	Body: title, description, status, due_date, assigned_to_id, team_id, is_private
DELETE	`/api/v1/tasks/:id`	Delete a task
GET	`/api/v1/teams`	List teams	Query: page, per_page
GET	`/api/v1/teams/:id`	Get a team (with members)
GET	`/api/v1/stats`	Tenant statistics	Returns task counts, team count, user count

Antwortformat

Einzelnes Element:

{
  "data": {
    "id": 1,
    "title": "My task",
    "status": "open",
    ...
  }
}

Liste mit Paginierung:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 42,
    "pages": 3,
    "has_next": true,
    "has_prev": false
  }
}

Fehler:

{
  "error": "Task not found",
  "status": 404
}

Examples

Create a task:

curl -X POST https://todo.moddy-blossom.at/api/v1/tasks \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Review Q1 report",
    "description": "Check all metrics",
    "due_date": "2026-04-01T09:00:00",
    "status": "open"
  }'

Complete a task:

curl -X PATCH https://todo.moddy-blossom.at/api/v1/tasks/42 \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "completed"}'

Get dashboard stats:

curl https://todo.moddy-blossom.at/api/v1/stats \
  -H "X-API-Key: YOUR_KEY"

📡 REST API