Skip to main content
POST
Create a task

Body

application/json
container
string
required

The container to create the task in: its id, short key (e.g. a Linear team key like ENG), or display name.

Minimum string length: 1
title
string
required
Minimum string length: 1
bodyMarkdown
string
state
string
itemType
string
organizationId
string

Optional organization ID to scope the request to. User credentials must belong to it; a secret key may only reference its own organization. Omitting it currently falls back to the session's active organization for user tokens (deprecated); a future release will require it for user-token callers.

Minimum string length: 1
clientRequestId
string

Optional caller-supplied idempotency key. When provided, retrying the same logical create with the same clientRequestId reuses the original result instead of creating a duplicate external task.

Minimum string length: 1

Response

201 - application/json

OK

identifier
string
required
title
string
required
url
string
required
state
string
required
reused
boolean
required
attribution
object