Get a task

curl --request GET \
  --url https://api.attio.com/v2/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "task_id": "649e34f4-c39a-4f4d-99ef-48a36bef8f04"
    },
    "content_plaintext": "Follow up on current software solutions",
    "deadline_at": "2023-01-01",
    "is_completed": false,
    "linked_records": [
      {
        "target_object_id": "people",
        "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "assignees": [
      {
        "referenced_actor_type": "workspace-member",
        "referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
      }
    ],
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

GET

tasks

{task_id}

Get a task

curl --request GET \
  --url https://api.attio.com/v2/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "task_id": "649e34f4-c39a-4f4d-99ef-48a36bef8f04"
    },
    "content_plaintext": "Follow up on current software solutions",
    "deadline_at": "2023-01-01",
    "is_completed": false,
    "linked_records": [
      {
        "target_object_id": "people",
        "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "assignees": [
      {
        "referenced_actor_type": "workspace-member",
        "referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
      }
    ],
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

task_id

string<uuid>

required

The ID of the task.

Example:

"649e34f4-c39a-4f4d-99ef-48a36bef8f04"

Response

Success

data

object

required

Show child attributes

data.id

object

required

Show child attributes

data.id.workspace_id

string<uuid>

required

The ID of the workspace the task belongs to.

Example:

"14beef7a-99f7-4534-a87e-70b564330a4c"

data.id.task_id

string<uuid>

required

The ID of the task.

Example:

"649e34f4-c39a-4f4d-99ef-48a36bef8f04"

data.content_plaintext

string

required

The plaintext representation of the task content. Inline linked records will appear as "@record name" and are returned in the linked_records property.

Example:

"Follow up on current software solutions"

data.deadline_at

string | null

required

The deadline date of the task. Returned as an ISO 8601 timestamp.

Example:

"2023-01-01"

data.is_completed

boolean

required

Whether the task has been completed.

Example:

false

data.linked_records

object[]

required

Records linked to the task. Creating record links within task content text is not possible via the API at present.

Show child attributes

data.linked_records.target_object_id

string

required

The ID of the parent object the task refers to. At present, only people and companies are supported.

Example:

"people"

data.linked_records.target_record_id

string<uuid>

required

The ID of the parent record the task refers to.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

data.assignees

object[]

required

Workspace members assigned to this task.

Show child attributes

data.assignees.referenced_actor_type

enum<string>

required

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

"workspace-member"

data.assignees.referenced_actor_id

string<uuid>

required

The ID of the workspace member actor assigned to this task.

Example:

"50cf242c-7fa3-4cad-87d0-75b1af71c57b"

data.created_by_actor

object

required

The actor that created this task.

Show child attributes

data.created_by_actor.id

string | null

An ID to identify the actor.

data.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.created_at

string

required

When the task was created.

Example:

"2022-11-21T13:22:49.061281000Z"

Create a task Delete a task

⌘I

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Get a task

Authorizations

Path Parameters

Response