{"openapi":"3.1.0","info":{"title":"Microsoft To Do Tool","description":"OpenAPI tool server for managing Microsoft To Do tasks through Microsoft Graph.","version":"1.0.0"},"paths":{"/list_lists":{"post":{"summary":"List Lists","description":"List Microsoft To Do task lists for the authorized personal Microsoft account.","operationId":"list_todo_lists","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoListsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/create_list":{"post":{"summary":"Create List","description":"Create a Microsoft To Do task list.","operationId":"create_todo_list","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateListRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoListItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/list_tasks":{"post":{"summary":"List Tasks","description":"List Microsoft To Do tasks from a list. Defaults to the built-in Tasks list.","operationId":"list_todo_tasks","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListTasksRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoTasksResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/create_task":{"post":{"summary":"Create Task","description":"Create a Microsoft To Do task. Supports due dates, reminders, importance, body notes and categories.","operationId":"create_todo_task","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TodoTaskItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/update_task":{"post":{"summary":"Update Task","description":"Update a Microsoft To Do task by task_id or by query. Use clear_due/clear_reminder to remove fields.","operationId":"update_todo_task","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/complete_task":{"post":{"summary":"Complete Task","description":"Complete or reopen a Microsoft To Do task by task_id or by query.","operationId":"complete_todo_task","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/delete_task":{"post":{"summary":"Delete Task","description":"Delete a Microsoft To Do task by task_id or by query.","operationId":"delete_todo_task","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTaskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}}},"components":{"schemas":{"CompleteTaskRequest":{"properties":{"list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Id","description":"Microsoft To Do list ID or visible list name, e.g. 't2' or 'Home'. Defaults to TODO_DEFAULT_LIST_ID."},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"Known Microsoft To Do task ID. If omitted, query is used."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Text to find the task when task_id is omitted."},"completed":{"type":"boolean","title":"Completed","default":true},"allow_first_match":{"type":"boolean","title":"Allow First Match","description":"Complete the first match if query matches multiple tasks.","default":false}},"type":"object","title":"CompleteTaskRequest"},"CreateListRequest":{"properties":{"display_name":{"type":"string","title":"Display Name","description":"New Microsoft To Do list name."}},"type":"object","required":["display_name"],"title":"CreateListRequest"},"CreateTaskRequest":{"properties":{"list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Id","description":"Microsoft To Do list ID or visible list name, e.g. 't2' or 'Home'. Defaults to TODO_DEFAULT_LIST_ID."},"title":{"type":"string","title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"due":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due","description":"Due datetime/date, interpreted in TODO_TIMEZONE when timezone is omitted."},"start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start","description":"Start datetime/date, interpreted in TODO_TIMEZONE when timezone is omitted."},"reminder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reminder","description":"Reminder datetime/date, interpreted in TODO_TIMEZONE when timezone is omitted."},"importance":{"type":"string","enum":["low","normal","high"],"title":"Importance","default":"normal"},"status":{"type":"string","enum":["notStarted","inProgress","completed","waitingOnOthers","deferred"],"title":"Status","default":"notStarted"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"}},"type":"object","required":["title"],"title":"CreateTaskRequest"},"DeleteTaskRequest":{"properties":{"list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Id","description":"Microsoft To Do list ID or visible list name, e.g. 't2' or 'Home'. Defaults to TODO_DEFAULT_LIST_ID."},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"Known Microsoft To Do task ID. If omitted, query is used."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Text to find the task when task_id is omitted."},"allow_first_match":{"type":"boolean","title":"Allow First Match","description":"Delete the first match if query matches multiple tasks.","default":false}},"type":"object","title":"DeleteTaskRequest"},"DeleteTaskResponse":{"properties":{"deleted":{"type":"boolean","title":"Deleted"},"list_id":{"type":"string","title":"List Id"},"task_id":{"type":"string","title":"Task Id"},"previous_task":{"$ref":"#/components/schemas/TodoTaskItem"},"matched_count":{"type":"integer","title":"Matched Count"},"candidates":{"items":{"$ref":"#/components/schemas/TodoTaskItem"},"type":"array","title":"Candidates"}},"type":"object","required":["deleted","list_id","task_id","previous_task","matched_count"],"title":"DeleteTaskResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ListTasksRequest":{"properties":{"list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Id","description":"Microsoft To Do list ID or visible list name, e.g. 't2' or 'Home'. Defaults to TODO_DEFAULT_LIST_ID or built-in Tasks."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Case-insensitive search in title, body preview and categories."},"status":{"anyOf":[{"type":"string","enum":["notStarted","inProgress","completed","waitingOnOthers","deferred"]},{"type":"null"}],"title":"Status","description":"Filter by Microsoft To Do task status. If omitted, completed tasks are hidden unless include_completed=true."},"include_completed":{"type":"boolean","title":"Include Completed","default":false},"due_after":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due After","description":"ISO datetime/date lower bound for dueDateTime."},"due_before":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Before","description":"ISO datetime/date upper bound for dueDateTime."},"max_results":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Max Results","default":20}},"type":"object","title":"ListTasksRequest"},"TodoListItem":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"is_owner":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Owner"},"is_shared":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Shared"},"wellknown_list_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wellknown List Name"}},"type":"object","required":["id"],"title":"TodoListItem"},"TodoListsResponse":{"properties":{"lists":{"items":{"$ref":"#/components/schemas/TodoListItem"},"type":"array","title":"Lists"}},"type":"object","required":["lists"],"title":"TodoListsResponse"},"TodoTaskItem":{"properties":{"id":{"type":"string","title":"Id"},"list_id":{"type":"string","title":"List Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body Preview"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"importance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Importance"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"created_date_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created Date Time"},"last_modified_date_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified Date Time"},"completed_date_time":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Completed Date Time"},"due_date_time":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Due Date Time"},"due_local_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Local Date"},"due_weekday":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Weekday"},"reminder_date_time":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Reminder Date Time"},"reminder_local_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reminder Local Date"},"reminder_weekday":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reminder Weekday"},"start_date_time":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Start Date Time"},"start_local_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Local Date"},"start_weekday":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Weekday"},"is_reminder_on":{"type":"boolean","title":"Is Reminder On","default":false},"week_starts_on":{"type":"string","title":"Week Starts On","default":"понедельник"}},"type":"object","required":["id","list_id"],"title":"TodoTaskItem"},"TodoTasksResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/TodoTaskItem"},"type":"array","title":"Tasks"}},"type":"object","required":["tasks"],"title":"TodoTasksResponse"},"UpdateTaskRequest":{"properties":{"list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Id","description":"Microsoft To Do list ID or visible list name, e.g. 't2' or 'Home'. Defaults to TODO_DEFAULT_LIST_ID."},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id","description":"Known Microsoft To Do task ID. If omitted, query is used."},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Text to find the task when task_id is omitted."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"due":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due"},"start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"},"reminder":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reminder"},"clear_due":{"type":"boolean","title":"Clear Due","default":false},"clear_start":{"type":"boolean","title":"Clear Start","default":false},"clear_reminder":{"type":"boolean","title":"Clear Reminder","default":false},"status":{"anyOf":[{"type":"string","enum":["notStarted","inProgress","completed","waitingOnOthers","deferred"]},{"type":"null"}],"title":"Status"},"importance":{"anyOf":[{"type":"string","enum":["low","normal","high"]},{"type":"null"}],"title":"Importance"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"allow_first_match":{"type":"boolean","title":"Allow First Match","description":"Update the first match if query matches multiple tasks.","default":false}},"type":"object","title":"UpdateTaskRequest"},"UpdateTaskResponse":{"properties":{"task":{"$ref":"#/components/schemas/TodoTaskItem"},"previous_task":{"$ref":"#/components/schemas/TodoTaskItem"},"matched_count":{"type":"integer","title":"Matched Count"},"candidates":{"items":{"$ref":"#/components/schemas/TodoTaskItem"},"type":"array","title":"Candidates"}},"type":"object","required":["task","previous_task","matched_count"],"title":"UpdateTaskResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}