Skip to main content
GET
Get a task

Authorizations

Authorization
string
header
required

OAuth 2.0 authorization code flow with PKCE (S256). See the authorization guide.

Scopes

tasks:read

Read your tasks, their assignees and the clients they are linked to

Path Parameters

task_id
string<uuid>
required

Response

The task.

is_external
boolean
required
read-only

True when this record has an active integration link, including an export from Vega. This is current linkage, not historical origin, and is independent of linked contacts or households. Associated records cannot be patched or deleted through this API, except that a meeting may patch reviewed alone. No provider/account details are exposed.

id
string<uuid>
required
name
string
required
status
string | null
required

One of the values of TaskStatus. A task synced from another CRM can carry another value, or none.

priority
string | null
required

low, medium or high, or null. A task synced from another CRM can carry another value.

due_on
string<date-time> | null
required

Null only for a task synced from another CRM without a due date.

completed_on
string<date-time> | null
required

When status was last set to completed. Null when the task is not completed.

assignee
object | null
required
contacts
object[]
required

The linked contacts the user can see.

households
object[]
required

The linked households the user can see.

created_on
string<date-time>
required
updated_on
string<date-time>
required
description
string | null
required

Markdown or plain text.

recurrence_rule
string | null
required

The repeating series rule (iCalendar RRULE), read-only. Partner changes still apply only to this task.

recurrence_id
string<uuid> | null
required

Identifies this task's repeating series, null for a non-repeating task.

workflow
object | null
required

The task's workflow, null when absent, deleted, or inaccessible to the connected user. Its stage is this task's stage, not necessarily the workflow's current stage.

owner
object | null
required
creator
object | null
required
tags
object[]
required