Update 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

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title?string

description?string

deadline?string

When this task is due — same shorthand grammar as on create (today, lifetime, q-2-2026, q2, d-20-11, …).

status?string

priority?|||

add_parent?string

Attach this task as a child of the given parent (full UUID or short id prefix).

remove_parent?string

Detach this task from the given parent (full UUID or short id prefix).

replace_parent?string

Replace the task's existing parent with this new one (full UUID or short id prefix). If the task has exactly one parent, that one is replaced. If it has multiple, you must also pass replace_parent_from to say which to replace.

replace_parent_from?string

When replacing among multiple parents, the existing parent to replace (full UUID or short id prefix; used with replace_parent).

block?string

Mark the given task as blocking this one — it should be done first (full UUID or short id prefix). Just a flag; nothing is enforced.

removeBlock?string

Remove the given task from this task’s "blocked by" list (full UUID or short id prefix).

Response Body

`application/json`

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

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "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",
  "children": [
    "4feb20ac-04ac-4bd8-9baa-d4924dafff88"
  ],
  "parents": [
    "4a2a1780-dcad-496e-bb7c-2bbf3a673e26"
  ]
}

Empty