Tasks & Daily Focus Timeline API
Endpoints for continuous day-by-day task slotting, concrete focus duration budgeting, status toggling, and 1-click rollover mechanics.
Base Path: /api/v1/tasks
Get Daily Agenda & Focus BudgetAuth
Retrieve prioritized tasks (Must Do, Should Do, Could Do) and total estimated focus duration for a specific date.
Status Codes
- Name
200- Type
- HTTP
- Description
- Daily tasks and metrics returned.
Request
GET/api/v1/tasks/today
Response 200
List Tasks (Multi-Value Filter)Auth
Universal task search with multi-value comma-separated filters (statuses=todo,in_progress & priorities=must,should), date ranges, and sorting.
Status Codes
- Name
200- Type
- HTTP
- Description
- Filtered list of tasks.
Request
GET/api/v1/tasks
Response 200
Create TaskAuth
Create an actionable task slotted on a specific calendar date with estimated focus minutes.
Payload Example
{
"title": "Implement WAL connection pooling tests",
"priority": "must",
"scheduled_date": "2026-08-27",
"estimated_minutes": 50,
"horizon_id": "hor_01j9c45d6e",
"tags": ["backend", "go", "db"]
}Status Codes
- Name
201- Type
- HTTP
- Description
- Task created.
- Name
400- Type
- HTTP
- Description
- Validation error.
- Name
title- Type
- string
- Required
- Description
- Task action title.
- Name
priority- Type
- string
- Required
- Description
- Priority category:
must,should, orcould.
- Name
scheduled_date- Type
- string
- Required
- Description
- Calendar date (YYYY-MM-DD).
- Name
estimated_minutes- Type
- number
- Required
- Description
- Estimated focus duration in minutes (e.g. 25, 50).
- Name
horizon_id- Type
- string
- Description
- Parent horizon identifier.
- Name
tags- Type
- array
- Description
- Array of string tag identifiers.
Request
POST/api/v1/tasks
Response 201
Toggle Task CompletionAuth
Instant status toggle between todo and done, updating horizon completion metrics automatically.
Status Codes
- Name
200- Type
- HTTP
- Description
- Task status toggled.
- Name
404- Type
- HTTP
- Description
- Task not found.
Request
POST/api/v1/tasks/{id}/toggle
Response 200
Rollover Task to Next DayAuth
Advance an unfinished task to the next business day with zero sprint ceremony drag.
Status Codes
- Name
200- Type
- HTTP
- Description
- Task rolled over.
- Name
404- Type
- HTTP
- Description
- Task not found.
Request
POST/api/v1/tasks/{id}/rollover
Response 200