Skip to main content
GET
Get a single task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

taskId
string
required

Task UUID.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Response

Task details.

task_id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
completed,
dismissed,
cancelled
task_type
string | null

Task type. Canonical values: call, email, linkedin. Other non-canonical values may appear on older rows; draft is only populated for canonical types.

task_title
string | null
priority
enum<string> | null
Available options:
urgent,
high,
medium,
low,
null
assignee_id
string | null
agent_id
string | null

ID of the agent that generated this task. Null for manually created tasks.

targets
object

Entities this task is about. All fields optional.

draft
null | object

Type-specific draft content. Shape varies by task_type.

reason
string | null
due_date
string<date-time> | null
created_at
string<date-time> | null
updated_at
string<date-time> | null
completed_at
string<date-time> | null
dismissed_at
string<date-time> | null
dismiss_reason
string | null