complete_omnifocus_task

OmniFocus · macOS

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Marca una tarea de OmniFocus como completada. Requiere OmniFocus Pro. Es preferible usar task_id de list_omnifocus_tasks o search_omnifocus_tasks. Si se usa task_name en su lugar, el nombre debe coincidir exactamente y, si varias tareas lo comparten, solo se completa la primera que se encuentre. Si se llama sin confirm, devuelve una vista previa; pase confirm=true para completarla. Devuelve el id y el nombre de la tarea completada, de modo que pueda indicarle al usuario cuál fue.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete; called without it, returns a preview.",
      "type": "boolean"
    },
    "task_id": {
      "description": "Exact task id from list_omnifocus_tasks (preferred). Provide this OR task_name.",
      "type": "string"
    },
    "task_name": {
      "description": "Task title to match when you don't have the id.",
      "type": "string"
    }
  },
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para complete_omnifocus_task. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "task_id": "demo-task-001"
}