Tasks
Endpoints for managing tasks — listing, creating, updating, and completing.
GET /api/v1/tasks
Returns a paginated list of tasks ordered from newest to oldest.
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
teamId | UUID | — | Filter to a specific team |
assigneeId | UUID | — | Filter by assigned member |
status | open | done | all | all | Filter by completion state |
limit | number (1–100) | 25 | Results per page |
cursor | string | — | Pagination cursor (from previous response) |
Example request
GET /api/v1/tasks?status=open&limit=10
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": {
"items": [
{
"id": "abc123",
"title": "Prepare presentation",
"description": null,
"deadline": "2026-06-01T10:00:00Z",
"assignee_id": "user-uuid",
"is_done": false,
"created_at": "2026-05-15T09:00:00Z",
"team_id": "team-uuid",
"user_id": "creator-uuid"
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTE1VDA5OjAwOjAwWiIsImlkIjoiYWJjMTIzIn0",
"hasMore": true
}
}
Pagination
When hasMore is true, pass nextCursor as the cursor parameter to fetch the next page:
GET /api/v1/tasks?status=open&limit=10&cursor=eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTE1VDA5OjAwOjAwWiIsImlkIjoiYWJjMTIzIn0
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Continue until hasMore is false.
Task object fields
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Task ID |
title | string | Task title |
description | string | null | Task description |
deadline | ISO 8601 datetime | null | Due date |
assignee_id | string (UUID) | null | Assigned member (null = shared pool — visible to all team members) |
is_done | boolean | Whether the task is completed |
created_at | ISO 8601 datetime | Creation timestamp |
team_id | string (UUID) | Team the task belongs to |
user_id | string (UUID) | User who created the task |
POST /api/v1/tasks
Creates a new task in the specified team.
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
teamId | UUID | ✓ | Team ID |
title | string (1–500 chars) | ✓ | Task title |
deadline | ISO 8601 datetime | ✓ | Due date |
description | string (max 5 000 chars) | — | Task description |
assigneeId | UUID | — | Assign to a member (null or omit = shared pool) |
Example request
POST /api/v1/tasks
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"teamId": "550e8400-e29b-41d4-a716-446655440000",
"title": "New task from API",
"deadline": "2026-06-15T12:00:00+02:00"
}
Example response (201 Created)
{
"data": {
"id": "new-task-uuid",
"title": "New task from API",
"description": null,
"deadline": "2026-06-15T10:00:00Z",
"assignee_id": null,
"is_done": false,
"created_at": "2026-05-16T08:00:00Z",
"team_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
GET /api/v1/tasks/:id
Returns details of a specific task.
Example request
GET /api/v1/tasks/abc123
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": {
"id": "abc123",
"title": "Prepare presentation",
"description": "Slides for the Monday meeting",
"deadline": "2026-06-01T10:00:00Z",
"assignee_id": null,
"is_done": false,
"created_at": "2026-05-15T09:00:00Z",
"team_id": "team-uuid",
"user_id": "creator-uuid"
}
}
PATCH /api/v1/tasks/:id
Partially updates a task. At least one field must be provided.
Request body (JSON)
| Field | Type | Description |
|---|---|---|
title | string (1–500 chars) | New title |
description | string | null | Description (null = clear) |
deadline | ISO 8601 datetime | null | Due date (null = clear) |
assigneeId | UUID | null | Assignment (null = shared pool) |
Example request
PATCH /api/v1/tasks/abc123
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
{
"title": "Renamed task",
"deadline": "2026-07-01T09:00:00Z"
}
Example response
{
"data": {
"id": "abc123",
"title": "Renamed task",
"description": null,
"deadline": "2026-07-01T09:00:00Z",
"assignee_id": null,
"is_done": false,
"created_at": "2026-05-15T09:00:00Z",
"team_id": "team-uuid"
}
}
POST /api/v1/tasks/:id/complete
Marks a task as completed. Idempotent — repeated calls have no effect.
Example request
POST /api/v1/tasks/abc123/complete
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": {
"id": "abc123",
"title": "Prepare presentation",
"is_done": true,
"completed_at": "2026-05-16T14:32:00Z"
}
}
POST /api/v1/tasks/:id/uncomplete
Marks a task as not completed. Idempotent.
Example request
POST /api/v1/tasks/abc123/uncomplete
Authorization: Bearer ukkora_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Example response
{
"data": {
"id": "abc123",
"title": "Prepare presentation",
"is_done": false,
"completed_at": null
}
}