Introduction
How-to guides
Endpoint reference
- Core endpoints
- Objects
- Attributes
- Records
- Lists
- Entries
- Workspace members
- Notes
- Tasks
- Threads
- Comments
- Webhooks
- Meta
- Standard objects
- OAuth 2.0
Update a task
Updates an existing task by task_id
. At present, only the deadline_at
, is_completed
, linked_records
, and assignees
fields can be updated.
Required scopes: task:read-write
, object_configuration:read
, record_permission:read
, user_management:read
.
curl --request PATCH \
--url https://api.attio.com/v2/tasks/{task_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"deadline_at": "2023-01-01T15:00:00.000000000Z",
"is_completed": false,
"linked_records": [
{
"target_object": "people",
"target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
}
],
"assignees": [
{
"referenced_actor_type": "workspace-member",
"referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}
]
}
}'
{
"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 to update.
"649e34f4-c39a-4f4d-99ef-48a36bef8f04"
Body
The deadline of the task, in ISO 8601 format.
"2023-01-01T15:00:00.000000000Z"
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 or slug of the parent object the tasks refers to. This can reference both standard and custom objects.`
"people"
The ID of the parent record the task refers to.
"891dcbfc-9141-415d-9b2a-2238a6cc012d"
Workspace members assigned to this task.
The actor type of the task assignee. Only workspace-member
actors can be assigned to tasks. Read more information on actor types here.
workspace-member
"workspace-member"
The ID of the actor assigned to this task.
"50cf242c-7fa3-4cad-87d0-75b1af71c57b"
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 PATCH \
--url https://api.attio.com/v2/tasks/{task_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"deadline_at": "2023-01-01T15:00:00.000000000Z",
"is_completed": false,
"linked_records": [
{
"target_object": "people",
"target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
}
],
"assignees": [
{
"referenced_actor_type": "workspace-member",
"referenced_actor_id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}
]
}
}'
{
"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"
}
}