# Get To-do lists & tasks
{% columns %}
{% column %}
#### Scenario
Get a list of To-do tasks for a user in Microsoft Graph using a GET REST function and display the tasks in a list jig.
**Resource links:**
* [List tasks](https://learn.microsoft.com/en-us/graph/api/todotasklist-list-tasks?view=graph-rest-1.0\&tabs=http) - MS Graph documentation
* [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
* [Configuring OAuth for MS Graph](https://docs.jigx.com/building-apps-with-jigx/data/data-providers/rest/microsoft-graph-oauth/configuring-oauth-for-ms-graph)
**Required OAuth scope** (least to most privilege):
Tasks.Read Tasks.ReadWrite
{% endcolumn %}
{% column %}
Task list
{% endcolumn %}
{% endcolumns %}
## Examples and code snippets
{% hint style="success" %}
When using the code and samples in this topic, remember that they are designed to function as part of a comprehensive solution. To fully benefit from the intended functionality and ensure compatibility, it is recommended that you use the entire solution rather than selecting individual components in isolation. Alternatively, you can use these samples as a guide to understand the underlying concepts and MS Graph API, which can help you integrate similar solutions into your projects more effectively. The entire MS Graph solution is available on [GitHub](https://github.com/jigx-com/jigx-samples/tree/main/quickstart/jigx-MS-Graph-demonstrator).
{% endhint %}
## General
{% tabs %}
{% tab title="index.jigx" %}
```yaml
name: ms-graph-demonstrator
title: MS Graph Demonstrator
description: A solution using Microsoft Graph APIs .
category: business
onLoad:
type: action.execute-action
options:
action: full-sync
onRefresh:
type: action.execute-action
options:
action: full-sync
expressions:
today: =$substring($now(), 0, 10)
todayStart: =$toMillis($today)
weekdayStr: =$floor($todayStart/86400000)
weekdayNum: =($weekdayStr + 4) % 7
startOfWeek: =$todayStart - ($weekdayNum * 86400000)
thisWeek: =$startOfWeek + 604800000
next7: =$number($todayStart) + 604800000
tabs:
home:
jigId: home
icon: home
```
{% endtab %}
{% tab title="home.jigx" %}
```yaml
title: Home
type: jig.grid
children:
- type: component.grid-item
options:
size: 2x2
children:
type: component.jig-widget
options:
jigId: view-user-jigx
widgetId: profileImage
- type: component.grid-item
options:
size: 2x2
children:
type: component.jig-widget
options:
jigId: calendar-summary
widgetId: nextDays
- type: component.grid-item
when: =$boolean(@ctx.datasources.next-meeting.locationAddress)
options:
size: 4x2
children:
type: component.jig-widget
options:
jigId: next-meeting
widgetId: meeting-location
- type: component.grid-item
options:
size: 2x2
children:
type: component.jig-widget
options:
jigId: list-email-messages
- type: component.grid-item
options:
size: 2x2
children:
type: component.jig-widget
options:
jigId: list-task-lists
widgetId: taskList
- type: component.grid-item
options:
size: 4x2
children:
type: component.jig-widget
options:
jigId: items-trending
widgetId: trending
```
{% endtab %}
{% endtabs %}
## Functions
MS Graph list To-do tasks function in [GitHub](https://github.com/jigx-com/jigx-samples/tree/main/quickstart/jigx-MS-Graph-demonstrator/functions/tasks).
{% tabs %}
{% tab title="get-all-todo-tasks.jigx" %}
```yaml
provider: DATA_PROVIDER_REST
method: POST
url: https://graph.microsoft.com/v1.0/$batch
inputTransform: taskListIds
outputTransform: |
$.responses.$map($, function($v, $i, $a) {
$v[$i].body.value.$merge([$,{ "toDoListId": $decodeUrlComponent($v.body."@odata.context".$substringAfter("lists('").$substringBefore("')/tasks")) }])
})
parameters:
accessToken:
location: header
required: true
type: string
value: microsoft.OAuth #Use manage.jigx.com to define credentials for your solution
Content-Type:
type: string
location: header
required: false
value: "application/json"
taskListIds:
type: string
location: body
required: true
errorTransform: |
{
"error": "No lists"
}
```
{% endtab %}
{% tab title="get-task-lists.jigx" %}
```yaml
provider: DATA_PROVIDER_REST
method: GET
url: https://graph.microsoft.com/v1.0/me/todo/lists
outputTransform: $
parameters:
accessToken:
location: header
required: true
type: string
value: microsoft.OAuth #Use manage.jigx.com to define credentials for your solution
$top:
type: string
location: query
required: false
value: 100
records: =$.value
continuation:
when: =$."@odata.nextLink"
url: =$."@odata.nextLink"
parameters:
accessToken:
location: header
required: true
type: string
value: microsoft.OAuth
errorTransform: |
{
"error": "No lists"
}
```
{% endtab %}
{% endtabs %}
## Jigs
MS Graph list To-do tasks jig in [GitHub](https://github.com/jigx-com/jigx-samples/blob/main/quickstart/jigx-MS-Graph-demonstrator/jigs/tasks/list-task-lists.jigx).
{% code title="list-task-lists.jigx" %}
```yaml
title: Task Lists
type: jig.list
icon: contact
header:
type: component.jig-header
options:
height: small
children:
type: component.image
options:
source:
uri: https://www.windowslatest.com/wp-content/uploads/2018/12/Office-apps-new-icons.jpg
onRefresh:
type: action.action-list
options:
actions:
- type: action.sync-entities
options:
provider: DATA_PROVIDER_REST
entities:
- entity: todo-task-lists
function: get-task-lists
parameters:
accessToken: microsoft.OAuth
datasources:
mydata:
type: datasource.sqlite
options:
provider: DATA_PROVIDER_LOCAL
entities:
- entity: todo-task-lists
- entity: todo-tasks
query:
SELECT json_extract(tlists.Data, '$.id') as tlId, json_extract(tlists.Data, '$.displayName') as tlDisplayName,
json_extract(tlists.Data, '$.isOwner') as isOwner, count(json_extract(tasks.Data, '$.id')) AS task_count
FROM [todo-task-lists] tlists
LEFT JOIN [todo-tasks] tasks ON json_extract(tlists.Data, '$.id') = json_extract(tasks.Data, '$.toDoListId')
Group by json_extract(tlists.Data, '$.id'),json_extract(tlists.Data, '$.displayName')
order by task_count desc
data: =@ctx.datasources.mydata
item:
type: component.list-item
options:
title: =@ctx.current.item.tlDisplayName
leftElement:
element: icon
icon: task-list
divider: solid
rightElement:
element: icon
icon: arrow-right
subtitle: |
=@ctx.current.item.isOwner? "Owner of the list: Yes":"Owner of the list: No"
label:
title: |
=@ctx.current.item.task_count
widgets:
taskList:
type: widget.list
options:
data: =@ctx.datasources.mydata
item:
type: component.list-item
options:
title: =@ctx.current.item.tlDisplayName
leftElement:
element: icon
icon: task-list
divider: solid
subtitle: |
="Number of Tasks: " & @ctx.current.item.task_count
```
{% endcode %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.jigx.com/examples/readme/data-providers/rest/ms-graph/graph-tasks/get-to-do-lists-_-tasks.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.