todo_complete_task

Herinneringen en Microsoft To Do · macOS · Windows

Effect: schrijven. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Markeert een Microsoft To Do-taak als voltooid. Het werkt via Apple Herinneringen, dat synchroniseert met To Do wanneer het Microsoft-account aan Herinneringen is toegevoegd, dus de wijziging verschijnt in To Do na de volgende synchronisatie. Geef de voorkeur aan task_id uit todo_list_tasks. Met `title` in plaats daarvan wordt de ene openstaande taak voltooid waarvan de titel die tekst bevat (hoofdletterongevoelig); als er meerdere overeenkomen, wordt er GEEN voltooid en worden ze vermeld met hun task_id. Zonder `list` worden alle Herinneringen-lijsten doorzocht, niet alleen die van To Do. Zonder confirm wordt een voorbeeld geretourneerd; geef confirm=true mee om te voltooien.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor todo_complete_task. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows

Doel

Markeert één taak als voltooid in Microsoft To Do / Outlook-taken, via de Outlook-desktopapp; alleen Windows. Zonder confirm=true verandert er niets: de aanroep retourneert een voorbeeld dat het onderwerp en de lijst herhaalt en de taak niet opzoekt, dus het zegt niet of de taak bestaat. Met confirm=true zoekt het de taak waarvan het onderwerp gelijk is aan `subject` (geen gedeeltelijke overeenkomst, geen taak-ID) en zet die op 100% voltooid. Zonder `list` zoekt het alleen in de hoofdmap Taken, niet in de submappen; met `list`, een naam of volledig pad uit todo_list_tasks, zoekt het alleen daar, en een onbekende lijst of een lijst die overeenkomt met meerdere mappen wordt met een fout geweigerd. Wanneer meerdere OPENSTAANDE taken in die map hetzelfde onderwerp hebben, wordt er geen voltooid: de aanroep mislukt en vermeldt de kandidaten, elk met een task_id; roep opnieuw aan met die task_id om er één te voltooien. Een ontbrekende taak retourneert 'not found', en een antwoord van Outlook dat de wijziging niet bevestigt, is een fout, nooit een succes. De taak wordt niet verwijderd; deze server heeft geen tool om hem te heropenen.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

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