Get a task
Get a single task by ID.
Required scopes: task:read
, object_configuration:read
, record_permission:read
, user_management:read
.
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
This API uses OAuth 2.0 with the authorization code grant flow.
Path Parameters
The ID of the task.
"649e34f4-c39a-4f4d-99ef-48a36bef8f04"
Response
Success
The plaintext representation of the task content. Inline linked records will appear as "@record name" and are returned in the linked_records
property.
"Follow up on current software solutions"
The deadline date of the task. Returned as an ISO 8601 timestamp.
"2023-01-01"
Whether the task has been completed.
false
Records linked to the task. Creating record links within task content text is not possible via the API at present.
The ID of the parent object the task refers to. At present, only people
and companies
are supported.
"people"
The ID of the parent record the task refers to.
"891dcbfc-9141-415d-9b2a-2238a6cc012d"
Workspace members assigned to this task.
The type of actor. Read more information on actor types here.
api-token
, workspace-member
, system
, app
"workspace-member"
The ID of the workspace member actor assigned to this task.
"50cf242c-7fa3-4cad-87d0-75b1af71c57b"
The actor that created this task.
An ID to identify the actor.
The type of actor. Read more information on actor types here.
api-token
, workspace-member
, system
, app
{
"type": "workspace-member",
"id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}
When the task was created.
"2022-11-21T13:22:49.061281000Z"
Was this page helpful?
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"
}
}