Skip to main content
POST
Create a project task
Creates a task under a project. The body is strict: projectId, title (1 to 200 characters), priority (low, medium, high or urgent), and optional description (up to 20,000 characters) and tags (up to 20, each 1 to 64 characters). The task starts in BACKLOG with kind generic and no assignee, and is attributed to the calling External App or API key. Creating needs projects:read (otherwise 404) and projects:manage (otherwise 403) at the project’s home, and the credential’s scopes must include projects:read as well as projects:manage, because the success returns the task (otherwise 403 naming projects:read, and nothing is created). Assignee, milestone, parent, dependencies, required skills, work-pool eligibility and external links are not accepted. Success is 201 with the post-write ProjectTaskDetail. Without an Idempotency-Key, repeating a create creates a second task. Only a project’s ordinary tasks are here. A factory task is read and changed through the factory task operations, and a task with no project is never returned. Assigning a task is done by a person in Console.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

projectId
string
required

The project the task belongs to, as GET /api/v2/projects/get returns it.

Minimum string length: 1

Body

application/json

A task under a project. It starts in BACKLOG with kind generic. Assignee, milestone, parent, dependencies, required skills, work-pool and external links are not accepted. Unknown fields are refused.

title
string
required

The task title, 1 to 200 characters, stored exactly as sent.

Required string length: 1 - 200
priority
enum<string>
required
Available options:
low,
medium,
high,
urgent
description
string

Up to 20,000 characters.

Maximum string length: 20000
tags
string[]

Up to 20 tags of 1 to 64 characters; replaces the stored list.

Maximum array length: 20
Required string length: 1 - 64

Response

Success

data
object
required
meta
object
required