todo_complete_task

Напоминания и Microsoft To Do · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Помечает задачу Microsoft To Do как выполненную. Работает через Apple Reminders, который синхронизируется с To Do, когда учетная запись Microsoft добавлена в Reminders, поэтому изменение появится в To Do после следующей синхронизации. Предпочтительно использовать task_id из todo_list_tasks. Если вместо него передан `title`, завершается единственная открытая задача, заголовок которой содержит этот текст (без учета регистра); если совпадений несколько, не завершается НИ ОДНА, и они перечисляются со своими task_id. Без `list` поиск идет по всем спискам Reminders, а не только по спискам To Do. Без confirm возвращается предварительный просмотр; для завершения передайте confirm=true.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для todo_complete_task. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "title": "Planning meeting"
}

Windows

Назначение

Помечает одну задачу как выполненную в Microsoft To Do / Outlook Tasks через настольное приложение Outlook; только Windows. Без confirm=true ничего не меняется: вызов возвращает предварительный просмотр, повторяющий тему и список и не ищущий задачу, поэтому он не сообщает, существует ли задача. С confirm=true ищется задача, тема которой равна `subject` (без частичного совпадения и без ID задачи), и она отмечается выполненной на 100%. Без `list` поиск идет только в корневой папке Tasks, а не в ее подпапках; с `list` (имя или полный путь из todo_list_tasks) — только там, а неизвестный список или список, соответствующий нескольким папкам, отклоняется с ошибкой. Если в этой папке несколько ОТКРЫТЫХ задач с одной темой, ни одна не завершается: вызов завершается ошибкой и перечисляет кандидатов, каждого с task_id; вызовите снова с этим task_id, чтобы завершить одну из них. Отсутствующая задача возвращает 'not found', а ответ Outlook, не подтверждающий изменение, считается ошибкой, а не успехом. Задача не удаляется; инструмента для ее повторного открытия на этом сервере нет.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "task_id": {
      "description": "A task_id listed by this tool when several open tasks share the subject. Completes exactly that task; subject and list are not needed.",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "type": "string"
    }
  },
  "type": "object"
}

Пример для документации

{
  "confirm": false,
  "title": "Planning meeting"
}