Skip to main content
POST
Create a task

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.

Body

application/json

The new Task resource

project
string<iri-reference>
Example:

"/api/v1/projects/1"

goal
string<iri-reference> | null
Example:

"/api/v1/goals/1"

title
string
description
string | null
status
string<iri-reference> | null
Example:

"/api/v1/issue_statuses/1"

priority
integer | null
default:2
assignee
string<iri-reference> | null
Example:

"/api/v1/users/1"

dateDue
string<date-time> | null
dateStart
string<date-time> | null
position
integer | null
progress
integer | null
default:0
estimatedMinutes
integer | null
dateCompleted
string<date-time> | null
type
string<iri-reference> | null
Example:

"/api/v1/issue_types/1"

blockedBy
array

Response

Task resource created

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