complete_task

This reference is generated from the published tool contract.

Behavior and boundaries

Overwrites the completion state of one writable task, marking it completed. The task must be returned by list_tasks or get_task. Repeating the call is safe and reports changed=false.

Permissions

Granted scopes, accounts, calendars and visibility rules limit access. Workspace administrators do not automatically gain access to other users’ accounts.

tasks:read, tasks:write

Consent and boundaries

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "accountId": {
      "type": "string",
      "minLength": 1
    },
    "taskListId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "taskId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    }
  },
  "required": [
    "accountId",
    "taskListId",
    "taskId"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "const": true
    },
    "changed": {
      "type": "boolean"
    },
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "needs-action",
            "in-progress",
            "completed",
            "waiting-on-others",
            "deferred"
          ]
        },
        "dueDate": {
          "type": "string"
        },
        "updatedAt": {
          "type": "string"
        },
        "writable": {
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "title",
        "status",
        "writable"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "found",
    "changed",
    "task"
  ],
  "additionalProperties": false
}

Errors and retries

Check the tool result for errors. Do not blindly retry writes after a timeout. Check the current resource or send status first.

Error handling