Updates from: 07/16/2022 01:15:37
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Todotasklist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/todotasklist-get.md
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
- "@odata.type": "#microsoft.graph.todoTaskList",
- "id": "5daae1ed-e1ed-5daa-ede1-aa5dede1aa5d",
- "displayName": "Monthly tasks",
- "isOwner": "true",
- "isShared": "false",
- "wellknownListName": "defaultList"
- }
+ "@odata.type": "#microsoft.graph.todoTaskList",
+ "id": "5daae1ed-e1ed-5daa-ede1-aa5dede1aa5d",
+ "displayName": "Monthly tasks",
+ "isOwner": true,
+ "isShared": false,
+ "wellknownListName": "defaultList"
} ```
v1.0 Searchhit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/searchhit.md
Represents a single result within the list of search results.
| Property | Type | Description | |:-|:|:|
-|hitId|String|The internal identifier for the item.|
+|hitId|String|The internal identifier for the item. The format of the identifier varies based on the entity type. For details, see [hitId format](#hitid-format).|
|rank|Int32|The rank or the order of the result.| |contentSource|String|The name of the content source which the **externalItem** is part of .| |summary|String|A summary of the result, if a summary is available.|
Represents a single result within the list of search results.
|_sortField (deprecated)|String|This property has been removed.| |_source (deprecated)|[entity](entity.md)|Renamed as **resource**. The underlying Graph representation of the search result.|
+### hitId format
+| Entity type | ID format | Example |
+|:-|:|:|
+|message|RestId|`AAMkAGIwMDA5MmY0LWY5ZTgtNGY5YS04NzczLWNhNjc0ZGIyZDBjYgBGAAAAAADm35sgHbzESapJ8_BjBlhEBwDAYtphe7dsRbDrOT-HAHoKAACmqNsoAADAYtphe7dsRbDrOT-HAHoKAAFsBhyEAAA=`|
+|event|EwsId|`AAMkAGIwMDA5MmY0LWY5ZTgtNGY5YS04NzczLWNhNjc0ZGIyZDBjYgFRAAgI232z8Q+AAEYAAAAA5t+bIB28xEmqSfPgYwZYRAcAwGLaYXu3bEWw6zk/xwB6CgAAAAABDQAAwGLaYXu3bEWw6zk/xwB6CgABGnD/jwAAEA==`|
+|list|GUID|`6249f5a0-c9fd-4103-8da5-8362fe911151`|
+|listItem|GUID|`89b4aeff-de77-4b0e-bec9-a20cd4f6c32d` |
+|site|Host,GUID,GUID|`microsoft.sharepoint.com,a5eb6988-c9ad-44be-b3b4-d334d01066c0,4c5ce7de-dbe6-4807-9909-3018f0b83266`|
+|drive|Encoded string|`b!kf7AlbfRu0SMqtfcmhLTwf7MGLd-Z0BEqfzvkoqsr21iQFpfPV09TIVf1sa8xOJ0` |
+|driveItem|Encoded string|`01ALOVTAX7V22IS566BZF35SNCBTKPNQZN`|
+|externalItem|Encoded string|`AAMkADRiYWU5MDRkLWE1NGEtNDg5OS1hZWM2LWIxOWZmNzQzMTdiYQBGAAAAAAAvZTGE+1bNQp4lDRL1ctayBwCQNOp97HTbQK/QVOV30iomAAAAEF6yAACQNOp97HTbQK/QVOV30iomAAAAG/DWAAA=` |
+|person|GUID@GUID|`497b7a2a-9e1a-48d7-80e8-2965d2fc3a81@72f988bf-86f1-41af-91ab-2d7cd011db47`|
+ ## JSON representation The following is a JSON representation of the resource.
v1.0 Todotask https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/todotask.md
This resource supports the following:
|Property|Type|Description| |:|:|:| |body|[itemBody](../resources/itembody.md)|The task body that typically contains information about the task.|
-|bodyLastModifiedDateTime|DateTimeOffset|The date and time when the task was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
+|bodyLastModifiedDateTime|DateTimeOffset|The date and time when the task body was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.| |completedDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|The date in the specified time zone that the task was finished.| |createdDateTime|DateTimeOffset|The date and time when the task was created. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
v1.0 Webhooks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/webhooks.md
Using the Microsoft Graph API, an app can subscribe to changes on the following
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br> Changes to multiple user presences:<br> `/communications/presences?$filter=id in ({id},{id}...)` | Yes | | Teams [team][] | Changes to any team in the tenant:<br>`/teams` <br>Changes to a specific team:<br>`/teams/{id}` | Yes | | To Do [baseTask][] (deprecated) | Changes to all task in a specific task list:<br>`/me/tasks/lists/{baseTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/tasks/lists/alltasks` | No |
-| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/todo/lists/alltasks` | No |
+| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks` | No |
| [user][] | Changes to all users:<br>`/users` <br>Changes to a specific user:<br>`/users/{id}`| No |
v1.0 Todotasklist Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/todotasklist-get.md
HTTP/1.1 200 OK
Content-Type: application/json {
- "value": {
- "@odata.type": "#microsoft.graph.todoTaskList",
- "id": "5daae1ed-e1ed-5daa-ede1-aa5dede1aa5d",
- "displayName": "Monthly tasks",
- "isOwner": "true",
- "isShared": "false",
- "wellknownListName": "defaultList"
- }
+ "@odata.type": "#microsoft.graph.todoTaskList",
+ "id": "5daae1ed-e1ed-5daa-ede1-aa5dede1aa5d",
+ "displayName": "Monthly tasks",
+ "isOwner": true,
+ "isShared": false,
+ "wellknownListName": "defaultList"
} ```
v1.0 Searchhit https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/searchhit.md
Represents a single result within the list of search results.
| Property | Type | Description | |:-|:|:|
-|contentSource|String|The name of the content source which the **externalItem** is part of .|
-|hitId|String|The internal identifier for the item.|
+|contentSource|String|The name of the content source that the **externalItem** is part of.|
+|hitId|String|The internal identifier for the item. The format of the identifier varies based on the entity type. For details, see [hitId format](#hitid-format).|
|rank|Int32|The rank or the order of the result.| |resultTemplateId|String|ID of the result template used to render the search result. This ID must map to a display layout in the **resultTemplates** dictionary that is also included in the [searchResponse](searchresponse.md).| |resource|[entity](entity.md)|The underlying Microsoft Graph representation of the search result.| |summary|String|A summary of the result, if a summary is available.|
+### hitId format
+
+| Entity type | ID format | Example |
+|:-|:|:|
+|message|RestId|`AAMkAGIwMDA5MmY0LWY5ZTgtNGY5YS04NzczLWNhNjc0ZGIyZDBjYgBGAAAAAADm35sgHbzESapJ8_BjBlhEBwDAYtphe7dsRbDrOT-HAHoKAACmqNsoAADAYtphe7dsRbDrOT-HAHoKAAFsBhyEAAA=`|
+|event|EwsId|`AAMkAGIwMDA5MmY0LWY5ZTgtNGY5YS04NzczLWNhNjc0ZGIyZDBjYgFRAAgI232z8Q+AAEYAAAAA5t+bIB28xEmqSfPgYwZYRAcAwGLaYXu3bEWw6zk/xwB6CgAAAAABDQAAwGLaYXu3bEWw6zk/xwB6CgABGnD/jwAAEA==`|
+|list|GUID|`6249f5a0-c9fd-4103-8da5-8362fe911151`|
+|listItem|GUID|`89b4aeff-de77-4b0e-bec9-a20cd4f6c32d` |
+|site|Host,GUID,GUID|`microsoft.sharepoint.com,a5eb6988-c9ad-44be-b3b4-d334d01066c0,4c5ce7de-dbe6-4807-9909-3018f0b83266`|
+|drive|Encoded string|`b!kf7AlbfRu0SMqtfcmhLTwf7MGLd-Z0BEqfzvkoqsr21iQFpfPV09TIVf1sa8xOJ0` |
+|driveItem|Encoded string|`01ALOVTAX7V22IS566BZF35SNCBTKPNQZN`|
+|externalItem|Encoded string|`AAMkADRiYWU5MDRkLWE1NGEtNDg5OS1hZWM2LWIxOWZmNzQzMTdiYQBGAAAAAAAvZTGE+1bNQp4lDRL1ctayBwCQNOp97HTbQK/QVOV30iomAAAAEF6yAACQNOp97HTbQK/QVOV30iomAAAAG/DWAAA=` |
+|person|GUID@GUID|`497b7a2a-9e1a-48d7-80e8-2965d2fc3a81@72f988bf-86f1-41af-91ab-2d7cd011db47`|
+ ## JSON representation The following is a JSON representation of the resource.
v1.0 Todotask https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/todotask.md
This resource supports the following:
|Property|Type|Description| |:|:|:| |body|[itemBody](../resources/itembody.md)|The task body that typically contains information about the task.|
-|bodyLastModifiedDateTime|DateTimeOffset|The date and time when the task was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
+|bodyLastModifiedDateTime|DateTimeOffset|The date and time when the task body was last modified. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
|categories|String collection|The categories associated with the task. Each category corresponds to the **displayName** property of an [outlookCategory](../resources/outlookcategory.md) that the user has defined.| |completedDateTime|[dateTimeTimeZone](../resources/datetimetimezone.md)|The date in the specified time zone that the task was finished.| |createdDateTime|DateTimeOffset|The date and time when the task was created. By default, it is in UTC. You can provide a custom time zone in the request header. The property value uses ISO 8601 format. For example, midnight UTC on Jan 1, 2020 would look like this: '2020-01-01T00:00:00Z'.|
v1.0 Webhooks https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/webhooks.md
Using the Microsoft Graph API, an app can subscribe to changes on the following
| Teams [channel][] | Changes to channels in all teams:<br>`/teams/getAllChannels` <br>Changes to channel in a specific team:<br>`/teams/{id}/channels` | Yes | | Teams [conversationMember][] | Changes to membership in a specific team:<br>`/teams/{id}/members` <br> Changes to membership in all channels under a specific team:<br>`teams/{id}/channels/getAllMembers` <br> Changes to membership in a specific chat:<br>`/chats/{id}/members` <br> Changes to membership in all chats:<br>`/teams/getAllMembers` | Yes | | Teams [team][] | Changes to any team in the tenant:<br>`/teams` <br>Changes to a specific team:<br>`/teams/{id}` | Yes |
-| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks`<br>Changes to all tasks:<br>`/me/todo/lists/alltasks` | No |
+| [To Do task][] | Changes to all task in a specific task list:<br>`/me/todo/lists/{todoTaskListId}/tasks` | No |
| [user][] | Changes to all users:<br>`/users` <br>Changes to a specific user:<br>`/users/{id}`| No | > **Note**: Any resource path that begins with `/users/{id}` can also accept `/me` to reference the signed-in user.