get-todo-task
get-todo-taskRead-only
Read a Microsoft To Do task and retrieve its body content, checklist items, and linked resources. Expand related entities or fetch all pages for complete data.
Instructions
Read the properties and relationships of a todoTask object.
💡 TIP: Returns a single To Do task. NOTE: $select is NOT supported — do not pass select parameter, Graph returns RequestBroker--ParseUri (400). Use $expand=linkedResources to include linked email/resource. Returns body content (HTML format), checklist items, and linked resources.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | Expand related entities | |
| select | No | Comma-separated fields to return, e.g. id,subject,from,receivedDateTime | |
| todoTaskId | Yes | Path parameter: todoTaskId | |
| fetchAllPages | No | Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search. | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| todoTaskListId | Yes | Path parameter: todoTaskListId | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |