Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Users.todo API

The users.todo API from Microsoft Entra ID (formerly Azure AD) — 30 operation(s) for users.todo.

GitHub OpenAPI

Operations 58

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /users/{user-id}/todo Get a user's To Do service · Get todo from users #
Ask an LLM
“What does the To Do root object for a user contain?”
“Can I read a user's Microsoft To Do service resource along with its lists?”
Tell an agent
Get the To Do service for user {user}.
Show the To Do root resource of {user} with its lists expanded.
PATCH /users/{user-id}/todo Update a user's To Do service object · Update the navigation property todo in users #
Ask an LLM
“Can I patch the To Do root object of a user directly?”
“Which properties of a user's To Do service can be updated?”
Tell an agent
Update the To Do service object for user {user}.
Patch the To Do root of {user} with new lists {lists}.
DELETE /users/{user-id}/todo Delete a user's To Do service object · Delete navigation property todo for users #
Ask an LLM
“Is it possible to delete the whole To Do navigation property for a user?”
“What happens if I remove a user's To Do root object?”
Tell an agent destructive · confirm first
Delete the To Do service object for user {user}.
Remove the entire To Do root of {user}.
GET /users/{user-id}/todo/lists List a user's To Do task lists · Get lists from users #
Ask an LLM
“Which task lists does a user have in Microsoft To Do?”
“Can I filter a user's To Do lists to only the shared ones?”
Tell an agent
List all To Do task lists for user {user}.
Show the shared task lists that {user} owns.
POST /users/{user-id}/todo/lists Create a To Do task list · Create new navigation property to lists for users #
Ask an LLM
“How do I create a new task list in someone's Microsoft To Do?”
“What can I name a new To Do list when I create it?”
Tell an agent
Create a To Do task list called {displayName} for user {user}.
Add a new task list named {displayName} to {user}'s To Do.
GET /users/{user-id}/todo/lists/{todoTaskList-id} Get a To Do task list · Get lists from users #
Ask an LLM
“What are the details of one specific To Do task list?”
“Is this To Do list shared, and does the user own it?”
Tell an agent
Get task list {list} for user {user}.
Show whether To Do list {list} of {user} is shared.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id} Rename or update a To Do task list · Update the navigation property lists in users #
Ask an LLM
“How do I rename an existing To Do task list?”
“Can I change a To Do list's name after creating it?”
Tell an agent
Rename To Do list {list} of user {user} to {displayName}.
Update task list {list} for {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id} Delete a To Do task list · Delete navigation property lists for users #
Ask an LLM
“Can I delete an entire To Do list along with its tasks?”
“How do I remove a task list from a user's To Do?”
Tell an agent destructive · confirm first
Delete To Do task list {list} for user {user}.
Remove list {list} from {user}'s To Do.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions List open extensions on a To Do list · Get extensions from users #
Ask an LLM
“Which open extensions are stored on a To Do task list?”
“Can I read custom data my app attached to a task list?”
Tell an agent
List the open extensions on To Do list {list} of user {user}.
Show custom extension data attached to task list {list} for {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/extensions Add an open extension to a To Do list · Create new navigation property to extensions for users #
Ask an LLM
“How can I attach custom app data to a To Do task list?”
“Can I create an open extension on a task list rather than on a task?”
Tell an agent
Add an open extension to To Do list {list} of user {user}.
Attach custom extension data to task list {list} for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Get an open extension on a To Do list · Get extensions from users #
Ask an LLM
“What's stored in one specific open extension on a task list?”
“Can I read a single extension on a To Do list by its id?”
Tell an agent
Get extension {extension} on To Do list {list} of user {user}.
Show list extension {extension} for list {list} and {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Update an open extension on a To Do list · Update the navigation property extensions in users #
Ask an LLM
“Can I change the custom data in an open extension on a task list?”
“How do I patch an existing task list extension?”
Tell an agent
Update extension {extension} on To Do list {list} of user {user}.
Patch list-level extension {extension} on list {list} for {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Delete an open extension from a To Do list · Delete navigation property extensions for users #
Ask an LLM
“Can I remove custom extension data from a To Do list?”
“What's the way to delete one open extension on a task list?”
Tell an agent destructive · confirm first
Delete extension {extension} from To Do list {list} of user {user}.
Remove list extension {extension} on list {list} for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/$count Count open extensions on a To Do list · Get the number of the resource #
Ask an LLM
“How many open extensions are on a To Do task list?”
“Is there any custom extension data on this task list at all?”
Tell an agent
Count the extensions on To Do list {list} of user {user}.
Tell me how many list-level extensions {list} has for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks List tasks in a To Do list · Get tasks from users #
Ask an LLM
“Which tasks are in one of my To Do lists?”
“Can I filter a To Do list's tasks to only the ones not yet completed?”
Tell an agent
Show every task with its title and status in To Do list {list} for user {user}.
Show incomplete tasks in list {list} of {user}, ordered by due date.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks Create a To Do task · Create new navigation property to tasks for users #
Ask an LLM
“How do I add a task to someone's To Do list with a due date?”
“Can I set importance and a reminder when creating a To Do task?”
Tell an agent
Create task {title} in To Do list {list} for user {user}.
Add task {title} due {dueDateTime} to list {list} of {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Get a To Do task · Get tasks from users #
Ask an LLM
“What's the status and due date of one specific To Do task?”
“Can I read a single task's body and reminder settings?”
Tell an agent
Get task {task} in list {list} for user {user}.
Show the due date and status of To Do task {task} in {list} for {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Update a To Do task · Update the navigation property tasks in users #
Ask an LLM
“How do I mark a To Do task as completed?”
“Can I change a task's due date or importance after creating it?”
Tell an agent
Mark task {task} in list {list} of user {user} as {status}.
Move the due date of task {task} in {list} for {user} to {dueDateTime}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Delete a To Do task · Delete navigation property tasks for users #
Ask an LLM
“Can I delete a task from a To Do list?”
“How do I permanently remove one To Do task?”
Tell an agent destructive · confirm first
Delete task {task} from list {list} of user {user}.
Remove To Do task {task} in {list} for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments List file attachments on a To Do task · Get attachments from users #
Ask an LLM
“Which files are attached to a To Do task?”
“Can I see the names and sizes of a task's attachments?”
Tell an agent
List attachments on task {task} in list {list} for user {user}.
Show file attachments for To Do task {task} in {list} of {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments Attach a small file to a To Do task · Create new navigation property to attachments for users #
Ask an LLM
“How do I attach a file to a To Do task?”
“What metadata do I give when adding an attachment, like name and content type?”
Tell an agent
Attach file {name} to task {task} in list {list} for user {user}.
Add attachment {name} of type {contentType} to To Do task {task} in {list} for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id} Get a To Do task attachment's details · Get attachments from users #
Ask an LLM
“What are the name, size and type of one task attachment?”
“Can I read a single attachment's metadata on a To Do task?”
Tell an agent
Get attachment {attachment} on task {task} in list {list} for user {user}.
Show metadata for attachment {attachment} of task {task} in {list}, {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id} Remove an attachment from a To Do task · Delete navigation property attachments for users #
Ask an LLM
“Can I delete a file attached to a To Do task?”
“What's the way to remove one attachment from a task?”
Tell an agent destructive · confirm first
Delete attachment {attachment} from task {task} in list {list} for user {user}.
Remove attached file {attachment} from To Do task {task}, list {list}, user {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Download a To Do task attachment's content · Get media content for the navigation property attachments from users #
Ask an LLM
“How do I download the actual file bytes of a To Do task attachment?”
“Can I get the raw media content of an attachment, not just its metadata?”
Tell an agent
Download the content of attachment {attachment} on task {task} in list {list} for user {user}.
Fetch the raw file for attachment {attachment}, task {task}, list {list}, user {user}.
PUT /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Replace a To Do task attachment's content · Update media content for the navigation property attachments in users #
Ask an LLM
“Can I overwrite the file content of an existing task attachment?”
“Is there a way to upload new bytes to an attachment already on a To Do task?”
Tell an agent
Replace the file content of attachment {attachment} on task {task} in list {list} for user {user}.
Upload new media for attachment {attachment}, task {task}, list {list}, {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Clear a To Do task attachment's content · Delete media content for the navigation property attachments in users #
Ask an LLM
“Can I delete only the media content of an attachment and keep the attachment entry?”
“What removes the stored bytes of a task attachment?”
Tell an agent destructive · confirm first
Delete the media content of attachment {attachment} on task {task} in list {list} for user {user}.
Clear the stored file bytes of attachment {attachment}, task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/$count Count attachments on a To Do task · Get the number of the resource #
Ask an LLM
“How many files are attached to a To Do task?”
“Does this task have any attachments at all?”
Tell an agent
Count the attachments on task {task} in list {list} for user {user}.
Tell me how many files are attached to To Do task {task} in {list} for {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/microsoft.graph.createUploadSession Start an upload session for a large task attachment · Invoke action createUploadSession #
Ask an LLM
“How do I upload a large file to a To Do task in chunks?”
“What do I need to start an upload session for a task attachment?”
Tell an agent
Create an upload session to attach a large file to task {task} in list {list} for user {user}.
Start a chunked upload for attachment {attachmentInfo} on task {task}, list {list}, user {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions List attachment upload sessions on a To Do task · Get attachmentSessions from users #
Ask an LLM
“Which attachment upload sessions are open on a To Do task?”
“Can I see pending chunked uploads for a task?”
Tell an agent
List the attachment upload sessions on task {task} in list {list} for user {user}.
Show open upload sessions for To Do task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Get a To Do attachment upload session · Get attachmentSessions from users #
Ask an LLM
“When does a specific attachment upload session expire?”
“Which byte ranges does an upload session still expect?”
Tell an agent
Get upload session {session} on task {task} in list {list} for user {user}.
Show the next expected ranges for upload session {session}, task {task}, list {list}, {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Update a To Do attachment upload session · Update the navigation property attachmentSessions in users #
Ask an LLM
“Can I change the expiration of an attachment upload session?”
“Is updating an upload session's expected ranges supported?”
Tell an agent
Set the expiration of upload session {session} on task {task}, list {list}, user {user} to {expirationDateTime}.
Update upload session {session} for task {task} in list {list} of {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Cancel a To Do attachment upload session · Delete navigation property attachmentSessions for users #
Ask an LLM
“Can I cancel an attachment upload session that I no longer need?”
“What deletes a stalled upload session on a To Do task?”
Tell an agent destructive · confirm first
Delete upload session {session} on task {task} in list {list} for user {user}.
Cancel attachment upload session {session} for task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Read content uploaded to an attachment session · Get content for the navigation property attachmentSessions from users #
Ask an LLM
“Can I read back the content streams already uploaded to an upload session?”
“What data has been received so far in a task's attachment upload session?”
Tell an agent
Get the uploaded content of session {session} on task {task} in list {list} for user {user}.
Read back bytes uploaded to session {session}, task {task}, list {list}, {user}.
PUT /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Upload content to an attachment session · Update content for the navigation property attachmentSessions in users #
Ask an LLM
“How do I send a chunk of file data into an open attachment upload session?”
“Can I put the next byte range into a To Do upload session?”
Tell an agent
Upload the next chunk into session {session} on task {task} in list {list} for user {user}.
Put file content into upload session {session}, task {task}, list {list}, {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Discard content uploaded to an attachment session · Delete content for the navigation property attachmentSessions in users #
Ask an LLM
“Can I throw away the bytes already uploaded to an attachment session?”
“What deletes the content stream of an upload session without deleting the session?”
Tell an agent destructive · confirm first
Delete the uploaded content of session {session} on task {task} in list {list} for user {user}.
Discard bytes uploaded to session {session}, task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/$count Count attachment upload sessions on a task · Get the number of the resource #
Ask an LLM
“How many attachment upload sessions exist for a To Do task?”
“Are there any unfinished uploads on this task?”
Tell an agent
Count the upload sessions on task {task} in list {list} for user {user}.
Tell me how many attachment sessions To Do task {task} in {list} has for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems List checklist items on a To Do task · Get checklistItems from users #
Ask an LLM
“What sub-steps are in a To Do task's checklist?”
“Which checklist items on a task are already checked off?”
Tell an agent
List the checklist items on task {task} in list {list} for user {user}.
Show the sub-steps of To Do task {task} in {list} for {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems Add a checklist item to a To Do task · Create new navigation property to checklistItems for users #
Ask an LLM
“How do I add a sub-step to a To Do task?”
“Can I create a checklist item that's already checked?”
Tell an agent
Add checklist item {displayName} to task {task} in list {list} for user {user}.
Create sub-step {displayName} on To Do task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Get a checklist item on a To Do task · Get checklistItems from users #
Ask an LLM
“Is one specific checklist item on a task checked, and when?”
“Can I read a single sub-step of a To Do task?”
Tell an agent
Get checklist item {item} on task {task} in list {list} for user {user}.
Show whether sub-step {item} of task {task} in {list} is checked for {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Update a checklist item on a To Do task · Update the navigation property checklistItems in users #
Ask an LLM
“How do I check off a sub-step on a To Do task?”
“Can I rename a checklist item after adding it?”
Tell an agent
Mark checklist item {item} on task {task} in list {list} for user {user} as checked: {isChecked}.
Rename sub-step {item} of task {task}, list {list}, {user} to {displayName}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Delete a checklist item from a To Do task · Delete navigation property checklistItems for users #
Ask an LLM
“Can I remove one sub-step from a task's checklist?”
“What deletes a checklist item on a To Do task?”
Tell an agent destructive · confirm first
Delete checklist item {item} from task {task} in list {list} for user {user}.
Remove sub-step {item} of To Do task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/$count Count checklist items on a To Do task · Get the number of the resource #
Ask an LLM
“How many sub-steps does a To Do task have?”
“Can I get the checklist item count without listing them?”
Tell an agent
Count checklist items on task {task} in list {list} for user {user}.
Tell me how many sub-steps To Do task {task} in {list} has for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions List open extensions on a To Do task · Get extensions from users #
Ask an LLM
“Which open extensions are attached to an individual To Do task?”
“Can I read custom app data stored on a task, not on its list?”
Tell an agent
List the open extensions on task {task} in list {list} for user {user}.
Show task-level custom extension data for task {task}, list {list}, {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions Add an open extension to a To Do task · Create new navigation property to extensions for users #
Ask an LLM
“How can I store custom app data on a single To Do task?”
“Can I create an open extension on a task?”
Tell an agent
Add an open extension to task {task} in list {list} for user {user}.
Attach task-level custom data to To Do task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Get an open extension on a To Do task · Get extensions from users #
Ask an LLM
“What's in one specific open extension on a To Do task?”
“Can I fetch a task extension by its id?”
Tell an agent
Get extension {extension} on task {task} in list {list} for user {user}.
Show task extension {extension} of task {task}, list {list}, {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Update an open extension on a To Do task · Update the navigation property extensions in users #
Ask an LLM
“Can I change the custom data stored in a task's open extension?”
“Is patching an existing task-level extension supported?”
Tell an agent
Update extension {extension} on task {task} in list {list} for user {user}.
Patch task extension {extension} of task {task}, list {list}, {user}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Delete an open extension from a To Do task · Delete navigation property extensions for users #
Ask an LLM
“Can I remove custom extension data from a single To Do task?”
“What deletes one open extension on a task?”
Tell an agent destructive · confirm first
Delete extension {extension} from task {task} in list {list} for user {user}.
Remove task extension {extension} on task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/$count Count open extensions on a To Do task · Get the number of the resource #
Ask an LLM
“How many open extensions does a single To Do task have?”
“Does this task carry any custom extension data?”
Tell an agent
Count the extensions on task {task} in list {list} for user {user}.
Tell me how many task-level extensions task {task} in {list} has for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources List linked resources on a To Do task · Get linkedResources from users #
Ask an LLM
“Which external items, like emails or web links, are linked to a To Do task?”
“Can I see which app a task was created from?”
Tell an agent
List the linked resources on task {task} in list {list} for user {user}.
Show external links attached to To Do task {task}, list {list}, {user}.
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources Link an external resource to a To Do task · Create new navigation property to linkedResources for users #
Ask an LLM
“How do I link a To Do task back to the item in my app it came from?”
“Can I add a web URL and app name as a linked resource on a task?”
Tell an agent
Link {webUrl} from app {applicationName} to task {task} in list {list} for user {user}.
Add linked resource {displayName} with external id {externalId} to task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id} Get a linked resource on a To Do task · Get linkedResources from users #
Ask an LLM
“What URL and app does one specific linked resource on a task point to?”
“Can I read a single linked resource by its id?”
Tell an agent
Get linked resource {resource} on task {task} in list {list} for user {user}.
Show the web URL of linked resource {resource}, task {task}, list {list}, {user}.
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id} Update a linked resource on a To Do task · Update the navigation property linkedResources in users #
Ask an LLM
“Can I change the URL a To Do task's linked resource points to?”
“Is renaming a linked resource on a task possible?”
Tell an agent
Change the URL of linked resource {resource} on task {task}, list {list}, user {user} to {webUrl}.
Rename linked resource {resource} of task {task} in {list} for {user} to {displayName}.
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id} Remove a linked resource from a To Do task · Delete navigation property linkedResources for users #
Ask an LLM
“Can I unlink an external item from a To Do task?”
“What deletes a linked resource on a task?”
Tell an agent destructive · confirm first
Delete linked resource {resource} from task {task} in list {list} for user {user}.
Unlink resource {resource} from To Do task {task}, list {list}, {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/$count Count linked resources on a To Do task · Get the number of the resource #
Ask an LLM
“How many external items are linked to a To Do task?”
“Does this task have any linked resources?”
Tell an agent
Count linked resources on task {task} in list {list} for user {user}.
Tell me how many links To Do task {task} in {list} has for {user}.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/$count Count tasks in a To Do list · Get the number of the resource #
Ask an LLM
“How many tasks are in a To Do list?”
“Can I get the task count of a list without fetching every task?”
Tell an agent
Count the tasks in To Do list {list} for user {user}.
Tell me how many tasks list {list} of {user} holds.
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/microsoft.graph.delta() Sync changed tasks in a To Do list · Invoke function delta #
Ask an LLM
“How do I get only the tasks that were added, updated or deleted in a list since my last sync?”
“Can I incrementally sync To Do tasks with a delta token?”
Tell an agent
Get task changes in To Do list {list} for user {user} since the last delta sync.
Run a delta query on the tasks of list {list} for {user}.
GET /users/{user-id}/todo/lists/$count Count a user's To Do task lists · Get the number of the resource #
Ask an LLM
“How many task lists does a user have in To Do?”
“Can I get just the number of a user's To Do lists?”
Tell an agent
Count the To Do task lists for user {user}.
Tell me how many task lists {user} has.
GET /users/{user-id}/todo/lists/microsoft.graph.delta() Sync changed To Do task lists · Invoke function delta #
Ask an LLM
“Which of a user's To Do lists were added, changed or removed since my last sync?”
“Can I track task list changes incrementally rather than re-reading all lists?”
Tell an agent
Get task list changes for user {user} since the last delta sync.
Run a delta query on the To Do lists of {user}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-todo-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-users-todo-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-ad-users-todo-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Users.todo API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (113 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-todo-api-openapi.yml