Update a task

Pass only the fields you want to change. Setting companyId clears any existing tenantId on the task and vice versa. A task can be linked to either, but not both.

For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.

This operation requires the following permissions:

task:edit

Mutation

mutation updateTask($input: UpdateTaskInput!) {
  updateTask(input: $input) {
    task {
      id
      ref
      title
      status
      priority
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "taskId": "ta_01HXXXXXXXXXXXXXXXXXXXXXXX",
    "status": "DONE"
  }
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog