v1

latestOpenAPI 3.0.12026-07-268028223.9 KB

Tasks

Get a task

Retrieve a task by ID

get/v1/tasks/{id}

Path parameters

idstring required

The task ID

Response

successful

idstring required

The task ID

titlestring required

Task title

descriptionstring nullable

Task description

deadline_atstring date-time nullable

Deadline for the task

all_dayboolean required

Whether this is an all-day task

status'todo' | 'done' required

Task status

priority'low_priority' | 'medium_priority' | 'high_priority' | 'urgent_priority' nullable

Task priority

is_privateboolean

When true, only the creator, assignee (or members of the assigned team), and collaborators can see this task. Use for sensitive tasks like HR or payroll.

completed_atstring date-time nullable

When the task was completed

created_atstring date-time required

When the task was created

updated_atstring date-time required

When the task was last updated

Example response

{
  "id": "abc123xyz",
  "title": "Follow up with client"
}