Create a task

Authorization

bearerAuth

AuthorizationBearer <token>

Your PerspecTask API key (starts with pt_live_). Each key carries scopes: tasks:read (GET), tasks:write (full create/update), and tasks:write:meta (create/update everything EXCEPT editing title/description of existing tasks — for automation that manages workflow without rewriting human-authored content).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

description?string

priority?|||

1 high, 2 medium, 3 low, 0 none.

deadline?string

When this task is due. A single shorthand token that sets both the period type and the date. Accepts: today, tomorrow, this/next week|month|quarter|year, lifetime, the bare letters d/w/m/q/y/l (= today, this week, this month, this quarter, this year, lifetime), or a column id (d-20-11-2026, w-23-2026, m-6-2026, q-2-2026, y-2026; trailing parts may be omitted to default to current month/year; the first number may be glued: q2, w23, d20).

parent_id?string

Parent task id — full UUID or a short id prefix.

Response Body

`application/json`

curl -X POST "https://example.com/tasks" \  -H "Content-Type: application/json" \  -d '{    "title": "string"  }'

{
  "id": "string",
  "pr_token": "string",
  "title": "string",
  "description": "string",
  "encrypted": true,
  "deadline": "string",
  "deadline_date": "2019-08-24T14:15:22Z",
  "status": "ACTIVE",
  "completion": "string",
  "worked_time": 0,
  "priority": 1,
  "created": "string",
  "blocked_by": [
    "string"
  ],
  "children": [
    "string"
  ],
  "parents": [
    "string"
  ]
}

Create a task

Authorization

Request Body

Response Body

201application/json

`application/json`