# Microsoft To Do Users.todo API

**Canonical:** https://apis.io/apis/microsoft-to-do/microsoft-to-do-users-todo-api/  
**Provider:** Microsoft To Do — https://apis.io/providers/microsoft-to-do/  
**Base URL:** https://graph.microsoft.com/v1.0  
**Documentation:** https://learn.microsoft.com/en-us/graph/api/resources/todo-overview

Microsoft To Do Users.todo API is one of 6 APIs that [Microsoft To Do](https://apis.io/providers/microsoft-to-do/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 8 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 8 JSON Schemas.

The users.todo API from Microsoft To Do — 30 operation(s) for users.todo.

## Operations (58)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{user-id}/todo` | Get todo from users |
| PATCH | `/users/{user-id}/todo` | Update the navigation property todo in users |
| DELETE | `/users/{user-id}/todo` | Delete navigation property todo for users |
| GET | `/users/{user-id}/todo/lists` | Get lists from users |
| POST | `/users/{user-id}/todo/lists` | Create new navigation property to lists for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}` | Get lists from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}` | Update the navigation property lists in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}` | Delete navigation property lists for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions` | Get extensions from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions` | Create new navigation property to extensions for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id}` | Get extensions from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id}` | Update the navigation property extensions in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id}` | Delete navigation property extensions for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/extensions/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks` | Get tasks from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks` | Create new navigation property to tasks for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}` | Get tasks from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}` | Update the navigation property tasks in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}` | Delete navigation property tasks for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments` | Get attachments from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments` | Create new navigation property to attachments for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}` | Get attachments from users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}` | Delete navigation property attachments for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value` | Get media content for the navigation property attachments from users |
| PUT | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value` | Update media content for the navigation property attachments in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value` | Delete media content for the navigation property attachments in users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/$count` | Get the number of the resource |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/createUploadSession` | Invoke action createUploadSession |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions` | Get attachmentSessions from users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}` | Get attachmentSessions from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}` | Update the navigation property attachmentSessions in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}` | Delete navigation property attachmentSessions for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content` | Get content for the navigation property attachmentSessions from users |
| PUT | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content` | Update content for the navigation property attachmentSessions in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content` | Delete content for the navigation property attachmentSessions in users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems` | Get checklistItems from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems` | Create new navigation property to checklistItems for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id}` | Get checklistItems from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id}` | Update the navigation property checklistItems in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id}` | Delete navigation property checklistItems for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions` | Get extensions from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions` | Create new navigation property to extensions for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id}` | Get extensions from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id}` | Update the navigation property extensions in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id}` | Delete navigation property extensions for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources` | Get linkedResources from users |
| POST | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources` | Create new navigation property to linkedResources for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id}` | Get linkedResources from users |
| PATCH | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id}` | Update the navigation property linkedResources in users |
| DELETE | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id}` | Delete navigation property linkedResources for users |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/{todoTaskList-id}/tasks/delta()` | Invoke function delta |
| GET | `/users/{user-id}/todo/lists/$count` | Get the number of the resource |
| GET | `/users/{user-id}/todo/lists/delta()` | Invoke function delta |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/microsoft-to-do/openapi/microsoft-to-do-users-todo-api-openapi.yml
- **Documentation** — https://learn.microsoft.com/en-us/graph/todo-concept-overview
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-todo-task-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-todo-task-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-upload-session-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-attachment-base-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-checklist-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-microsoft-graph-attachment-session-schema.json
- **Documentation** — https://learn.microsoft.com/en-us/graph/api/resources/todo-overview
- **Reference** — https://learn.microsoft.com/en-us/graph/api/resources/todotask
- **Authentication** — https://learn.microsoft.com/en-us/graph/auth/
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-generic-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/microsoft-to-do/json-schema/microsoft-to-do-generic-object-schema.json

## Other Microsoft To Do APIs (5)

- [Microsoft to Do LinkedResources API](https://apis.io/apis/microsoft-to-do/microsoft-to-do-linkedresources-api/)
- [Microsoft to Do TaskLists API](https://apis.io/apis/microsoft-to-do/microsoft-to-do-tasklists-api/)
- [Microsoft to Do Tasks API](https://apis.io/apis/microsoft-to-do/microsoft-to-do-tasks-api/)
- [Microsoft To Do Me.todo API](https://apis.io/apis/microsoft-to-do/microsoft-to-do-me-todo-api/)
- [Microsoft To Do Checklist Items API](https://apis.io/apis/microsoft-to-do/microsoft-to-do-checklist-items-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-to-do/microsoft-to-do-users-todo-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-to-do/.