API Reference · Incidents · Tasks
Update task status
Mutation
updateTaskStatusChanges the status of a task and records the change on the timeline of the incident it belongs to.
updateTaskStatus(
organizationId: ID!
taskId: ID!
status: TaskStatus
): Task!Arguments
Field
Type
Returns
Task!
Field
Type
Example
mutation UpdateTaskStatus($organizationId: ID!, $taskId: ID!, $status: TaskStatus) {
updateTaskStatus(organizationId: $organizationId, taskId: $taskId, status: $status) {
id
taskTemplateId
name
description
status
assigneeId
relatedResourceId
createdAt
updatedAt
assignee {
firstname
lastname
avatar
}
relatedResource {
__typename
... on Incident {
id
title
summary
createdAt
viewCount
}
}
}
}Example response
{
"data": {
"updateTaskStatus": {
"id": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"taskTemplateId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"name": "Example name",
"description": "Example description",
"status": "OPEN",
"assigneeId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"relatedResourceId": "01JB3X7T9QK2M4N6P8R0S2T4V6",
"createdAt": "2026-01-01T12:00:00Z",
"updatedAt": "2026-01-01T12:00:00Z",
"assignee": {
"firstname": "Example firstname",
"lastname": "Example lastname",
"avatar": "Example avatar"
},
"relatedResource": {
"__typename": "Incident",
"id": 1,
"title": "Example title",
"summary": "Example summary",
"createdAt": "2026-01-01T12:00:00Z",
"viewCount": 1
}
}
}
}