Skip to main content
GET
List tasks

Authorizations

Api-Token
string
header
required

Server-to-server authentication. Generate a token in the admin UI at Settings → Developers → API Access. Send the raw token in the Api-Token header — there is no Bearer prefix.

Tokens can be marked read-only at creation time, in which case the API rejects any non-GET request with 403 Forbidden.

Query Parameters

page
integer
default:1

The collection page number

itemsPerPage
integer
default:30

The number of items per page

Required range: 0 <= x <= 100
pagination
boolean

Enable or disable pagination

project
string
project[]
string[]
goal
string
goal[]
string[]
status
string
status[]
string[]
priority
integer
priority[]
integer[]
assignee
string
assignee[]
string[]
taskAssignees.user
string
taskAssignees.user[]
string[]
title
string
order[position]
enum<string>
default:asc
Available options:
asc,
desc
order[dateCreated]
enum<string>
default:asc
Available options:
asc,
desc
order[dateDue]
enum<string>
default:asc
Available options:
asc,
desc
order[priority]
enum<string>
default:asc
Available options:
asc,
desc
exists[assignee]
boolean
exists[taskAssignees]
boolean
assigneeUser
string

Filter tasks by assignee (legacy or multi-assignee)

Response

200 - application/json

Task collection

id
integer
read-only
uuid
string | null
project
object
goal
object | null
title
string
description
string | null
status
object | null
priority
integer | null
default:2
assignee
object | null
createdBy
object | null
dateDue
string<date-time> | null
dateStart
string<date-time> | null
position
integer | null
progress
integer | null
default:0
estimatedMinutes
integer | null
dateCreated
string<date-time>
read-only
dateUpdated
string<date-time> | null
read-only
dateCompleted
string<date-time> | null
subtasks
string[] | null
type
object | null
mainPost
object | null
commentsCount
integer
default:0
taskAssignees
object[]
blockedBy
array
blocks
array
read-only
assigneeCompletionStats
(string | null)[]
read-only
subtaskStats
(string | null)[]
read-only
canComplete
any