Skip to content
Ukkora

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

ParameterTypeDefaultDescription
teamIdUUID—Filter to a specific team
assigneeIdUUID—Filter by assigned member
statusopen | done | allallFilter by completion state
limitnumber (1–100)25Results per page
cursorstring—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

FieldTypeDescription
idstring (UUID)Task ID
titlestringTask title
descriptionstring | nullTask description
deadlineISO 8601 datetime | nullDue date
assignee_idstring (UUID) | nullAssigned member (null = shared pool — visible to all team members)
is_donebooleanWhether the task is completed
created_atISO 8601 datetimeCreation timestamp
team_idstring (UUID)Team the task belongs to
user_idstring (UUID)User who created the task

POST /api/v1/tasks

Creates a new task in the specified team.

Request body (JSON)

FieldTypeRequiredDescription
teamIdUUID✓Team ID
titlestring (1–500 chars)✓Task title
deadlineISO 8601 datetime✓Due date
descriptionstring (max 5 000 chars)—Task description
assigneeIdUUID—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)

FieldTypeDescription
titlestring (1–500 chars)New title
descriptionstring | nullDescription (null = clear)
deadlineISO 8601 datetime | nullDue date (null = clear)
assigneeIdUUID | nullAssignment (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
  }
}

Usage measurement

We would like to measure how Ukkora gets used — it helps us fix what does not work. We use Google Analytics and Microsoft Clarity, which store cookies in your browser. Without your consent they are not loaded.