diff --git a/api-reference/beta/api/drive_get.md b/api-reference/beta/api/drive_get.md index 08ad8aae6458d..27a4832c4c214 100644 --- a/api-reference/beta/api/drive_get.md +++ b/api-reference/beta/api/drive_get.md @@ -35,7 +35,7 @@ Here is an example of the request. "name": "get_drive" }--> ```http -GET https://graph.microsoft.com/v1.0/drive +GET https://graph.microsoft.com/beta/drive ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/drive_list.md b/api-reference/beta/api/drive_list.md index 901d0f329b536..54eeab3b16ba9 100644 --- a/api-reference/beta/api/drive_list.md +++ b/api-reference/beta/api/drive_list.md @@ -31,7 +31,7 @@ Here is an example of the request. "name": "get_drives" }--> ```http -GET https://graph.microsoft.com/v1.0/drives +GET https://graph.microsoft.com/beta/drives ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/drive_list_items.md b/api-reference/beta/api/drive_list_items.md index c07146297dc77..a685ea3a423b5 100644 --- a/api-reference/beta/api/drive_list_items.md +++ b/api-reference/beta/api/drive_list_items.md @@ -32,7 +32,7 @@ Here is an example of the request. "name": "get_items" }--> ```http -GET https://graph.microsoft.com/v1.0/drive/items +GET https://graph.microsoft.com/beta/drive/items ``` ##### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. diff --git a/api-reference/beta/api/drive_list_special.md b/api-reference/beta/api/drive_list_special.md index 1b681ad60fc3a..be4afce259955 100644 --- a/api-reference/beta/api/drive_list_special.md +++ b/api-reference/beta/api/drive_list_special.md @@ -31,7 +31,7 @@ Here is an example of the request. "name": "get_special" }--> ```http -GET https://graph.microsoft.com/v1.0/drive/special +GET https://graph.microsoft.com/beta/drive/special ``` ##### Response Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. diff --git a/api-reference/beta/api/drive_post_items.md b/api-reference/beta/api/drive_post_items.md index 3db3860cb8f4a..37643c0fa14a4 100644 --- a/api-reference/beta/api/drive_post_items.md +++ b/api-reference/beta/api/drive_post_items.md @@ -35,7 +35,7 @@ Here is an example of the request. "name": "create_item_from_drive" }--> ```http -POST https://graph.microsoft.com/v1.0/drive +POST https://graph.microsoft.com/beta/drive ``` In the request body, supply a JSON representation of [item](../resources/driveitem.md) object. ##### Response diff --git a/api-reference/beta/api/item_invite.md b/api-reference/beta/api/item_invite.md index c316357d8edb3..324f59da1bd7d 100644 --- a/api-reference/beta/api/item_invite.md +++ b/api-reference/beta/api/item_invite.md @@ -1,7 +1,6 @@ # Send a sharing invitation Sends a sharing invitation to an existing item. A sharing invitation creates a unique sharing link and sends an email to the recipient of the invitation that includes the sharing link. -Using the invite action is more secure than creating a sharing link, because the link is only valid for the recipient of the sharing invitation and cannot be reused by other users. ### Prerequisites One of the following **scopes** is required to execute this API: @@ -46,7 +45,7 @@ Here is an example of the request. "name": "item_invite" }--> ```http -POST https://graph.microsoft.com/v1.0/drive/root/Microsoft.Graph.invite +POST https://graph.microsoft.com/beta/drive/root/Microsoft.Graph.invite Content-type: application/json Content-length: 313 diff --git a/api-reference/beta/api/item_list_permissions.md b/api-reference/beta/api/item_list_permissions.md index cf2b794d2ee00..4a7272075116e 100644 --- a/api-reference/beta/api/item_list_permissions.md +++ b/api-reference/beta/api/item_list_permissions.md @@ -46,7 +46,7 @@ Here is an example of the request. "name": "get_permissions" }--> ```http -GET https://graph.microsoft.com/v1.0/drive/root/permissions +GET https://graph.microsoft.com/beta/drive/root/permissions ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/item_post_children.md b/api-reference/beta/api/item_post_children.md index a24cdcc56a081..339a3edb93a34 100644 --- a/api-reference/beta/api/item_post_children.md +++ b/api-reference/beta/api/item_post_children.md @@ -36,7 +36,7 @@ Here is an example of the request. "name": "create_item_from_item" }--> ```http -POST https://graph.microsoft.com/v1.0/drive/root +POST https://graph.microsoft.com/beta/drive/root ``` In the request body, supply a JSON representation of [item](../resources/driveitem.md) object. ##### Response diff --git a/api-reference/beta/api/item_post_permissions.md b/api-reference/beta/api/item_post_permissions.md index bfd7827f8eff5..f981ebb99e4fa 100644 --- a/api-reference/beta/api/item_post_permissions.md +++ b/api-reference/beta/api/item_post_permissions.md @@ -35,7 +35,7 @@ Here is an example of the request. "name": "create_permission_from_item" }--> ```http -POST https://graph.microsoft.com/v1.0/drive/root +POST https://graph.microsoft.com/beta/drive/root ``` In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. ##### Response diff --git a/api-reference/beta/api/permission_delete.md b/api-reference/beta/api/permission_delete.md index e07a5cadfce86..4eece7da5e3e0 100644 --- a/api-reference/beta/api/permission_delete.md +++ b/api-reference/beta/api/permission_delete.md @@ -38,7 +38,7 @@ Here is an example of the request. "name": "delete_permission" }--> ```http -DELETE https://graph.microsoft.com/v1.0/drive/root/permissions/ +DELETE https://graph.microsoft.com/beta/drive/root/permissions/ ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/permission_get.md b/api-reference/beta/api/permission_get.md index 1abd2e2cd0dbd..ea786085cafb0 100644 --- a/api-reference/beta/api/permission_get.md +++ b/api-reference/beta/api/permission_get.md @@ -35,7 +35,7 @@ Here is an example of the request. "name": "get_permission" }--> ```http -GET https://graph.microsoft.com/v1.0/drive/root/permissions/ +GET https://graph.microsoft.com/beta/drive/root/permissions/ ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/permission_update.md b/api-reference/beta/api/permission_update.md index b442f67d49706..cb3f2526b6d28 100644 --- a/api-reference/beta/api/permission_update.md +++ b/api-reference/beta/api/permission_update.md @@ -39,7 +39,7 @@ Here is an example of the request. "name": "update_permission" }--> ```http -PATCH https://graph.microsoft.com/v1.0/drive/root/permissions/ +PATCH https://graph.microsoft.com/beta/drive/root/permissions/ Content-type: application/json Content-length: 762 diff --git a/api-reference/beta/api/photo_delete.md b/api-reference/beta/api/photo_delete.md index 52e3e4dd775f1..d06b6081a9b0b 100644 --- a/api-reference/beta/api/photo_delete.md +++ b/api-reference/beta/api/photo_delete.md @@ -36,7 +36,7 @@ Here is an example of the request. "name": "delete_photo" }--> ```http -DELETE https://graph.microsoft.com/v1.0/users//photo +DELETE https://graph.microsoft.com/beta/users//photo ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/photo_get.md b/api-reference/beta/api/photo_get.md index f3f74ff372907..f584e5a35610a 100644 --- a/api-reference/beta/api/photo_get.md +++ b/api-reference/beta/api/photo_get.md @@ -33,7 +33,7 @@ Here is an example of the request. "name": "get_photo" }--> ```http -GET https://graph.microsoft.com/v1.0/users//photo +GET https://graph.microsoft.com/beta/users//photo ``` ##### Response Here is an example of the response. diff --git a/api-reference/beta/api/photo_update.md b/api-reference/beta/api/photo_update.md index 5b49fb8cd78f7..1ff890e725273 100644 --- a/api-reference/beta/api/photo_update.md +++ b/api-reference/beta/api/photo_update.md @@ -33,7 +33,7 @@ Here is an example of the request. "name": "update_photo" }--> ```http -PATCH https://graph.microsoft.com/v1.0/users//photo +PATCH https://graph.microsoft.com/beta/users//photo Content-type: application/json Content-length: 53 diff --git a/api-reference/beta/resources/driveitem.md b/api-reference/beta/resources/driveitem.md index d7e4dd88496a7..ea8949b181bf4 100644 --- a/api-reference/beta/resources/driveitem.md +++ b/api-reference/beta/resources/driveitem.md @@ -10,21 +10,20 @@ For example, if an item behaves as a [folder](folder.md), it will have the **fol | [Get item](../api/item_get.md) | [driveitem](driveitem.md) | Read properties and relationships of item object. | | [Create item](../api/item_post_children.md) | [driveitem](driveitem.md) | Create a new item by posting to the children collection. | | [List children](../api/item_list_children.md) | [driveitem](driveitem.md) collection | Get a children object collection. | -| [Create permission](../api/item_post_permissions.md) | [permission](permission.md) | Create a new permission by posting to the permissions collection. | +| [Create permission](../api/item_invite.md) | [permission](permission.md) | Create a new permission by sending a sharing invitation. | | [List permissions](../api/item_list_permissions.md) | [permission](permission.md) collection | Get a permission object collection. | | [List thumbnails](../api/item_list_thumbnails.md) | [thumbnailSet](thumbnailset.md) collection | Get a thumbnailSet object collection. | -| [update](../api/item_update.md) | [driveitem](driveitem.md) | Update item object. | -| [delete](../api/item_delete.md) | None | Delete item object. | -| [copy](../api/item_copy.md) | [driveitem](driveitem.md) | Copy an item to another location in the drive. | -| [createLink](../api/item_createlink.md) | [permission](permission.md) | Create a sharing link to allow users to access the content without signing in. | -| [invite](../api/item_invite.md) | [permission](permission.md) collection | Invite users to access the item by adding permissions and sending them a notification. | -| [search](../api/item_search.md) | [driveitem](driveitem.md) collection | Search for items matching a query. | +| [Update](../api/item_update.md) | [driveitem](driveitem.md) | Update item object. | +| [Delete](../api/item_delete.md) | None | Delete item object. | +| [CreateLink](../api/item_createlink.md) | [permission](permission.md) | Create a sharing link to allow users to access the content without signing in. | +| [Search](../api/item_search.md) | [driveitem](driveitem.md) collection | Search for items matching a query. | | [Copy](../api/item_copy.md) | [driveitem](driveitem.md) | Creates a copy of an item (including any children) on OneDrive, under a new parent.| | [Move](../api/item_move.md) | [driveitem](driveitem.md) | Update the parent folder for an item by ID or path. To move an item, you update its parentReference property.| | [Download content](../api/item_downloadcontent.md)| See API for details| Download the contents for an item.| | [Upload content](../api/item_uploadcontent.md)| See API for details| The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call.| + ### Properties | Property | Type |Description| |:---------------|:--------|:----------| diff --git a/api-reference/beta/resources/notes.md b/api-reference/beta/resources/notes.md index 1a9445d1f0c48..cea4386592c79 100644 --- a/api-reference/beta/resources/notes.md +++ b/api-reference/beta/resources/notes.md @@ -32,17 +32,17 @@ The following permission scopes provide levels of access to OneNote notebooks. C | Scope (enterprise) | Permission in Azure portal | Description | |:-------|:------|:------| -| Notes.Create | Create pages in OneNote notebooks | Can view the titles of your notebooks and sections; create new pages in any location. Cannot view or edit existing pages. | -| Notes.ReadWrite.CreatedByApp | Application-only OneNote notebook access | Can view the titles of your notebooks and sections; create new pages; view and modify pages created by the app. Cannot view or modify pages created by other apps or in password protected sections. | -| Notes.Read | View OneNote notebooks | Can view the contents of your notebooks and sections. Cannot create new pages; modify existing pages; access password protected sections. | -| Notes.ReadWrite | View and modify OneNote notebooks | Can view the titles of your notebooks and sections; view and modify all your pages; create new pages. Cannot access password protected sections. | +| Notes.Create | Create pages in user notebooks (preview) | Can view the titles of your notebooks and sections; create new pages in any location. Cannot view or edit existing pages. | +| Notes.ReadWrite.CreatedByApp | Limited notebook access (preview) | Can view the titles of your notebooks and sections; create new pages; view and modify pages created by the app. Cannot view or modify pages created by other apps or in password protected sections. | +| Notes.Read | Read user notebooks (preview) | Can view the contents of your notebooks and sections. Cannot create new pages; modify existing pages; access password protected sections. | +| Notes.ReadWrite | Read and write user notebooks (preview) | Can view the titles of your notebooks and sections; view and modify all your pages; create new pages. Cannot access password protected sections. | **Scopes for personal notebooks shared by other users and group notebooks that the current user can access** | Scope (enterprise) | Permission in Azure portal | Description | |:-------|:------|:------| -| Notes.Read.All | View OneNote notebooks in your organization | Can view the contents of notebooks and sections in all notebooks that the signed-in user has access to. Cannot create new pages; modify existing pages; access password protected sections. | -| Notes.ReadWrite.All | View and modify OneNote notebooks in your organization | Can view the titles of notebooks and sections; view and modify all pages; create new pages in all notebooks that the signed-in user has access to. Cannot access password protected sections. | +| Notes.Read.All | Read all notebooks that the user can access (preview) | Can view the contents of notebooks and sections in all notebooks that the signed-in user has access to. Cannot create new pages; modify existing pages; access password protected sections. | +| Notes.ReadWrite.All | Read and write notebooks that the user can access (preview) | Can view the titles of notebooks and sections; view and modify all pages; create new pages in all notebooks that the signed-in user has access to. Cannot access password protected sections. | **Note:** Accessing SharePoint site notebooks through the Graph API is currently not supported. @@ -97,4 +97,4 @@ If you're accessing group notebooks, you'll need a Groups permission scope to ge "keywords": "", "section": "documentation", "tocPath": "" -}--> \ No newline at end of file +}--> diff --git a/api-reference/v1.0/api/attachment_delete.md b/api-reference/v1.0/api/attachment_delete.md index eed06d2f88646..00252b814fa46 100644 --- a/api-reference/v1.0/api/attachment_delete.md +++ b/api-reference/v1.0/api/attachment_delete.md @@ -1,12 +1,12 @@ # Delete attachment -Delete attachment. +Delete an attachment from a calendar event or mail message. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.ReadWrite* -* If accessing attachments in Events: *Calendars.ReadWrite* -* If accessing attachments in Posts: *Groups.ReadWrite* +* If accessing attachments in Messages: _Mail.ReadWrite_ +* If accessing attachments in Events: _Calendars.ReadWrite_ +* If accessing attachments in Posts: _Groups.Read_ ### HTTP request @@ -55,4 +55,4 @@ HTTP/1.1 204 No Content "keywords": "", "section": "documentation", "tocPath": "" -}--> \ No newline at end of file +}--> diff --git a/api-reference/v1.0/api/attachment_get.md b/api-reference/v1.0/api/attachment_get.md index 50271c5fb91e5..f5db5acb18550 100644 --- a/api-reference/v1.0/api/attachment_get.md +++ b/api-reference/v1.0/api/attachment_get.md @@ -4,9 +4,9 @@ Retrieve the properties and relationships of attachment object. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.Read* -* If accessing attachments in Events: *Calendars.Read* -* If accessing attachments in Posts: *Groups.Read* +* If accessing attachments in Messages: _Mail.Read_ +* If accessing attachments in Events: _Calendars.Read_ +* If accessing attachments in Posts: _Groups.Read_ ### HTTP request diff --git a/api-reference/v1.0/api/calendar_post_calendarview.md b/api-reference/v1.0/api/calendar_post_calendarview.md new file mode 100644 index 0000000000000..88b9702817ca6 --- /dev/null +++ b/api-reference/v1.0/api/calendar_post_calendarview.md @@ -0,0 +1,85 @@ +# Create Event + +Use this API to create a new Event. +### Prerequisites +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ +### HTTP request + +```http +POST /users//calendar/calendarView +POST /groups//calendar/calendarView +POST /drive/root/createdByUser/calendar/calendarView + +``` +### Request headers +| Name | Type | Description| +|:---------------|:--------|:----------| +| Authorization | string | Bearer . Required. | + +### Request body +In the request body, supply a JSON representation of [Event](../resources/event.md) object. + + +### Response +If successful, this method returns `201, Created` response code and [Event](../resources/event.md) object in the response body. + +### Example +##### Request +Here is an example of the request. + +```http +POST https://graph.microsoft.com/v1.0/me/calendar/calendarView +Content-type: application/json +Content-length: 285 + +{ + "originalStartTimeZone": "originalStartTimeZone-value", + "originalEndTimeZone": "originalEndTimeZone-value", + "responseStatus": { + "response": { + }, + "time": "datetime-value" + }, + "iCalUId": "iCalUId-value", + "reminderMinutesBeforeStart": 99, + "isReminderOn": true +} +``` +In the request body, supply a JSON representation of [event](../resources/event.md) object. +##### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. + +```http +Content-type: application/json +Content-length: 285 + +{ + "originalStartTimeZone": "originalStartTimeZone-value", + "originalEndTimeZone": "originalEndTimeZone-value", + "responseStatus": { + "response": { + }, + "time": "datetime-value" + }, + "iCalUId": "iCalUId-value", + "reminderMinutesBeforeStart": 99, + "isReminderOn": true +} +``` + + + diff --git a/api-reference/v1.0/api/calendar_post_events.md b/api-reference/v1.0/api/calendar_post_events.md index 4d4ad8b70e9ea..fb83debdbbdd0 100644 --- a/api-reference/v1.0/api/calendar_post_events.md +++ b/api-reference/v1.0/api/calendar_post_events.md @@ -51,6 +51,7 @@ Content-length: 285 }, "time": "datetime-value" }, + "iCalUId": "iCalUId-value", "reminderMinutesBeforeStart": 99, "isReminderOn": true } diff --git a/api-reference/v1.0/api/conversation_delete.md b/api-reference/v1.0/api/conversation_delete.md index fc5f1fa87464a..50c1d45d5ab19 100644 --- a/api-reference/v1.0/api/conversation_delete.md +++ b/api-reference/v1.0/api/conversation_delete.md @@ -2,18 +2,18 @@ Delete conversation. ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: *Group.ReadWrite.All* + ### HTTP request ```http DELETE /groups//conversations/ -DELETE /groups//conversations/ ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. diff --git a/api-reference/v1.0/api/conversation_get.md b/api-reference/v1.0/api/conversation_get.md index 6a0cc4d50c05c..ee74d5b1cea24 100644 --- a/api-reference/v1.0/api/conversation_get.md +++ b/api-reference/v1.0/api/conversation_get.md @@ -8,14 +8,14 @@ One of the following **scopes** is required to execute this API: ```http GET /groups//conversations/ -GET /groups//conversations/ + ``` ### Optional query parameters This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response. ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. diff --git a/api-reference/v1.0/api/conversation_list_threads.md b/api-reference/v1.0/api/conversation_list_threads.md index a485888dc9564..c529c756e1bdc 100644 --- a/api-reference/v1.0/api/conversation_list_threads.md +++ b/api-reference/v1.0/api/conversation_list_threads.md @@ -8,19 +8,18 @@ One of the following **scopes** is required to execute this API: ```http GET /groups//conversations//threads -GET /groups//conversations//threads ``` ### Optional query parameters This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response. ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. ### Response -If successful, this method returns a `200 OK` response code and collection of [ConversationThread](../resources/conversationthread.md) objects in the response body. +If successful, this method returns a `200 OK` response code and collection of [conversationThread](../resources/conversationthread.md) objects in the response body. ### Example ##### Request Here is an example of the request. diff --git a/api-reference/v1.0/api/conversation_post_threads.md b/api-reference/v1.0/api/conversation_post_threads.md index 3f378d936e448..bdcc725384b2c 100644 --- a/api-reference/v1.0/api/conversation_post_threads.md +++ b/api-reference/v1.0/api/conversation_post_threads.md @@ -8,19 +8,19 @@ One of the following **scopes** is required to execute this API: ```http POST /groups//conversations//threads -POST /groups//conversations//threads + ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body -In the request body, supply a JSON representation of [ConversationThread](../resources/conversationthread.md) object. +In the request body, supply a JSON representation of [conversationThread](../resources/conversationthread.md) object. ### Response -If successful, this method returns `201, Created` response code and [ConversationThread](../resources/conversationthread.md) object in the response body. +If successful, this method returns `201, Created` response code and [conversationThread](../resources/conversationthread.md) object in the response body. ### Example ##### Request diff --git a/api-reference/v1.0/api/conversation_update.md b/api-reference/v1.0/api/conversation_update.md index 5207c259efb19..91beb5cc31f55 100644 --- a/api-reference/v1.0/api/conversation_update.md +++ b/api-reference/v1.0/api/conversation_update.md @@ -8,23 +8,19 @@ One of the following **scopes** is required to execute this API: ```http PATCH /groups//conversations/ -PATCH /groups//conversations/ + ``` ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. | Property | Type |Description| |:---------------|:--------|:----------| -|hasAttachments|Boolean|Indicates whether the Conversation has at least one attachment.| -|lastDeliveredDateTime|DateTimeOffset|| -|preview|String|| |topic|String|The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.| -|uniqueSenders|String|All the users that sent a message to this Conversation.| ### Response If successful, this method returns a `200 OK` response code and updated [conversation](../resources/conversation.md) object in the response body. @@ -42,12 +38,6 @@ Content-length: 181 { "topic": "topic-value", - "hasAttachments": true, - "lastDeliveredDateTime": "datetime-value", - "uniqueSenders": [ - "uniqueSenders-value" - ], - "preview": "preview-value" } ``` ##### Response diff --git a/api-reference/v1.0/api/conversationthread_delete.md b/api-reference/v1.0/api/conversationthread_delete.md index 3ab47fc128d05..a6bb767f7940a 100644 --- a/api-reference/v1.0/api/conversationthread_delete.md +++ b/api-reference/v1.0/api/conversationthread_delete.md @@ -2,7 +2,9 @@ Delete conversationThread. ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: +*Group.ReadWrite.All* + ### HTTP request ```http @@ -11,9 +13,9 @@ DELETE /groups//conversations//threads/ ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. diff --git a/api-reference/v1.0/api/conversationthread_get.md b/api-reference/v1.0/api/conversationthread_get.md index e2afad1155cdd..c13c001ede1bf 100644 --- a/api-reference/v1.0/api/conversationthread_get.md +++ b/api-reference/v1.0/api/conversationthread_get.md @@ -2,7 +2,9 @@ Retrieve the properties and relationships of conversationthread object. ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: +*Group.ReadWrite.All; Group.Read.All* + ### HTTP request ```http @@ -13,9 +15,9 @@ GET /groups//conversations//threads/ ### Optional query parameters This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response. ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. diff --git a/api-reference/v1.0/api/conversationthread_list_posts.md b/api-reference/v1.0/api/conversationthread_list_posts.md index 5d958a19fbd9f..e1384787185fd 100644 --- a/api-reference/v1.0/api/conversationthread_list_posts.md +++ b/api-reference/v1.0/api/conversationthread_list_posts.md @@ -3,6 +3,8 @@ Retrieve a list of post objects. ### Prerequisites One of the following **scopes** is required to execute this API: +*Group.ReadWrite.All; Group.Read.All* + ### HTTP request ```http @@ -13,9 +15,9 @@ GET /groups//conversations//threads//posts ### Optional query parameters This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response. ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. diff --git a/api-reference/v1.0/api/conversationthread_post_posts.md b/api-reference/v1.0/api/conversationthread_post_posts.md index 1708af98f373b..40850bb087b65 100644 --- a/api-reference/v1.0/api/conversationthread_post_posts.md +++ b/api-reference/v1.0/api/conversationthread_post_posts.md @@ -2,7 +2,9 @@ Use this API to create a new Post. ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: +*Group.ReadWrite.All* + ### HTTP request ```http @@ -11,16 +13,16 @@ POST /groups//conversations//threads//posts ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body -In the request body, supply a JSON representation of [Post](../resources/post.md) object. +In the request body, supply a JSON representation of [post](../resources/post.md) object. ### Response -If successful, this method returns `201, Created` response code and [Post](../resources/post.md) object in the response body. +If successful, this method returns `201, Created` response code and [post](../resources/post.md) object in the response body. ### Example ##### Request @@ -40,8 +42,6 @@ Content-length: 414 }, "content": "content-value" }, - "receivedDateTime": "datetime-value", - "hasAttachments": true, "from": { "emailAddress": { "name": "name-value", @@ -54,7 +54,6 @@ Content-length: 414 "address": "address-value" } }, - "conversationThreadId": "conversationThreadId-value" } ``` In the request body, supply a JSON representation of [post](../resources/post.md) object. diff --git a/api-reference/v1.0/api/conversationthread_reply.md b/api-reference/v1.0/api/conversationthread_reply.md index 171b2df70d358..141aa07ee2715 100644 --- a/api-reference/v1.0/api/conversationthread_reply.md +++ b/api-reference/v1.0/api/conversationthread_reply.md @@ -2,7 +2,9 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: +*Group.ReadWrite.All* + ### HTTP request ```http @@ -11,16 +13,16 @@ POST /groups//conversations//threads//microsoft.graph.reply ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, provide a JSON object with the following parameters. | Parameter | Type |Description| |:---------------|:--------|:----------| -|post|Post|| +|post|[post](../resources/post.md)|| ### Response If successful, this method returns `200, OK` response code. It does not return anything in the response body. @@ -45,21 +47,6 @@ Content-length: 1131 }, "content": "content-value" }, - "receivedDateTime": "datetime-value", - "hasAttachments": true, - "from": { - "emailAddress": { - "name": "name-value", - "address": "address-value" - } - }, - "sender": { - "emailAddress": { - "name": "name-value", - "address": "address-value" - } - }, - "conversationThreadId": "conversationThreadId-value", "newParticipants": [ { "emailAddress": { @@ -68,16 +55,9 @@ Content-length: 1131 } } ], - "conversationId": "conversationId-value", - "createdDateTime": "datetime-value", - "lastModifiedDateTime": "datetime-value", - "changeKey": "changeKey-value", "categories": [ "categories-value" ], - "id": "id-value", - "inReplyTo": { - }, "attachments": [ { "lastModifiedDateTime": "datetime-value", @@ -92,7 +72,6 @@ Content-length: 1131 } ``` -##### Response ##### Response Here is an example of the response. ```http @@ -11,23 +13,16 @@ PATCH /groups//conversations//threads/ ``` ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. | Property | Type |Description| |:---------------|:--------|:----------| -|ccRecipients|Recipient|| -|hasAttachments|Boolean|| -|isLocked|Boolean|| -|lastDeliveredDateTime|DateTimeOffset|| -|preview|String|| -|toRecipients|Recipient|| |topic|String|| -|uniqueSenders|String|| ### Response If successful, this method returns a `200 OK` response code and updated [conversationThread](../resources/conversationthread.md) object in the response body. @@ -44,28 +39,7 @@ Content-type: application/json Content-length: 419 { - "toRecipients": [ - { - "emailAddress": { - "name": "name-value", - "address": "address-value" - } - } - ], "topic": "topic-value", - "hasAttachments": true, - "lastDeliveredDateTime": "datetime-value", - "uniqueSenders": [ - "uniqueSenders-value" - ], - "ccRecipients": [ - { - "emailAddress": { - "name": "name-value", - "address": "address-value" - } - } - ] } ``` ##### Response diff --git a/api-reference/v1.0/api/event_accept.md b/api-reference/v1.0/api/event_accept.md index d0caab2bd4c75..645dc8781f133 100644 --- a/api-reference/v1.0/api/event_accept.md +++ b/api-reference/v1.0/api/event_accept.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_decline.md b/api-reference/v1.0/api/event_decline.md index 1e9b3e6fa6aaf..4d2b2512e3383 100644 --- a/api-reference/v1.0/api/event_decline.md +++ b/api-reference/v1.0/api/event_decline.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_delete.md b/api-reference/v1.0/api/event_delete.md index 2cd6a217443d4..6767e94efaf80 100644 --- a/api-reference/v1.0/api/event_delete.md +++ b/api-reference/v1.0/api/event_delete.md @@ -2,8 +2,7 @@ Delete event. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_dismissreminder.md b/api-reference/v1.0/api/event_dismissreminder.md index 3db8ee37fb55b..6a1a12ecdb2e5 100644 --- a/api-reference/v1.0/api/event_dismissreminder.md +++ b/api-reference/v1.0/api/event_dismissreminder.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_get.md b/api-reference/v1.0/api/event_get.md index 2af1ae348f01b..21415119d965b 100644 --- a/api-reference/v1.0/api/event_get.md +++ b/api-reference/v1.0/api/event_get.md @@ -2,8 +2,7 @@ Retrieve the properties and relationships of event object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.Read* +One of the following **scopes** is required to execute this API: _Calendars.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_list_attachments.md b/api-reference/v1.0/api/event_list_attachments.md index 3a61686ebe29d..19890896566cd 100644 --- a/api-reference/v1.0/api/event_list_attachments.md +++ b/api-reference/v1.0/api/event_list_attachments.md @@ -2,8 +2,7 @@ Retrieve a list of attachment objects. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.Read* +One of the following **scopes** is required to execute this API: _Calendars.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_list_instances.md b/api-reference/v1.0/api/event_list_instances.md index 6aef9f67c4cda..507a2cce5c634 100644 --- a/api-reference/v1.0/api/event_list_instances.md +++ b/api-reference/v1.0/api/event_list_instances.md @@ -2,8 +2,7 @@ Retrieve a list of event objects. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.Read* +One of the following **scopes** is required to execute this API: _Calendars.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_post_attachments.md b/api-reference/v1.0/api/event_post_attachments.md index 85593283f7afe..46b7c85729cc6 100644 --- a/api-reference/v1.0/api/event_post_attachments.md +++ b/api-reference/v1.0/api/event_post_attachments.md @@ -2,8 +2,7 @@ Use this API to create a new Attachment. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_post_instances.md b/api-reference/v1.0/api/event_post_instances.md index 0a87b162155c0..cbfe0b1a3526c 100644 --- a/api-reference/v1.0/api/event_post_instances.md +++ b/api-reference/v1.0/api/event_post_instances.md @@ -2,8 +2,7 @@ Use this API to create a new Event. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_snoozereminder.md b/api-reference/v1.0/api/event_snoozereminder.md index 406a437d92c28..c2eb7b89d549b 100644 --- a/api-reference/v1.0/api/event_snoozereminder.md +++ b/api-reference/v1.0/api/event_snoozereminder.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_tentativelyaccept.md b/api-reference/v1.0/api/event_tentativelyaccept.md index 6ee51e8da4c1a..9b0eefda06d17 100644 --- a/api-reference/v1.0/api/event_tentativelyaccept.md +++ b/api-reference/v1.0/api/event_tentativelyaccept.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/event_update.md b/api-reference/v1.0/api/event_update.md index 1fa3865ebb321..7b3ae9f9a9558 100644 --- a/api-reference/v1.0/api/event_update.md +++ b/api-reference/v1.0/api/event_update.md @@ -2,8 +2,7 @@ Update the properties of event object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Calendars.ReadWrite* +One of the following **scopes** is required to execute this API: _Calendars.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/eventmessage_delete.md b/api-reference/v1.0/api/eventmessage_delete.md index b6ad509acebf4..8d62cfcfee893 100644 --- a/api-reference/v1.0/api/eventmessage_delete.md +++ b/api-reference/v1.0/api/eventmessage_delete.md @@ -2,8 +2,7 @@ Delete eventMessage. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/eventmessage_get.md b/api-reference/v1.0/api/eventmessage_get.md index 2bd2a590c0a1c..08775c5a3d65e 100644 --- a/api-reference/v1.0/api/eventmessage_get.md +++ b/api-reference/v1.0/api/eventmessage_get.md @@ -2,8 +2,7 @@ Retrieve the properties and relationships of eventmessage object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Read* +One of the following **scopes** is required to execute this API: _Mail.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/eventmessage_list_attachments.md b/api-reference/v1.0/api/eventmessage_list_attachments.md index 81b4f4bea616f..7b11981eb19d4 100644 --- a/api-reference/v1.0/api/eventmessage_list_attachments.md +++ b/api-reference/v1.0/api/eventmessage_list_attachments.md @@ -2,8 +2,7 @@ Retrieve a list of attachment objects. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Read* +One of the following **scopes** is required to execute this API: _Mail.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/eventmessage_post_attachments.md b/api-reference/v1.0/api/eventmessage_post_attachments.md index 9eff4edd64240..c2397e553d3aa 100644 --- a/api-reference/v1.0/api/eventmessage_post_attachments.md +++ b/api-reference/v1.0/api/eventmessage_post_attachments.md @@ -2,8 +2,7 @@ Use this API to create a new Attachment. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/eventmessage_update.md b/api-reference/v1.0/api/eventmessage_update.md index dbc4cb02200bf..982b482e0324f 100644 --- a/api-reference/v1.0/api/eventmessage_update.md +++ b/api-reference/v1.0/api/eventmessage_update.md @@ -2,8 +2,7 @@ Update the properties of eventmessage object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/fileattachment_delete.md b/api-reference/v1.0/api/fileattachment_delete.md index e93954f64affc..e2591bce9b6b7 100644 --- a/api-reference/v1.0/api/fileattachment_delete.md +++ b/api-reference/v1.0/api/fileattachment_delete.md @@ -4,8 +4,8 @@ Delete fileAttachment. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.ReadWrite* -* If accessing attachments in Events: *Calendars.ReadWrite* +* If accessing attachments in Messages: _Mail.ReadWrite_ +* If accessing attachments in Events: _Calendars.ReadWrite_ ### HTTP request diff --git a/api-reference/v1.0/api/fileattachment_get.md b/api-reference/v1.0/api/fileattachment_get.md index 2b5465c81bd39..1dd23b70b3488 100644 --- a/api-reference/v1.0/api/fileattachment_get.md +++ b/api-reference/v1.0/api/fileattachment_get.md @@ -4,8 +4,8 @@ Retrieve the properties and relationships of fileattachment object. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.Read* -* If accessing attachments in Events: *Calendars.Read* +* If accessing attachments in Messages: _Mail.Read_ +* If accessing attachments in Events: _Calendars.Read_ ### HTTP request diff --git a/api-reference/v1.0/api/group_resetunseencount.md b/api-reference/v1.0/api/group_resetunseencount.md index 98955298d89d5..275c3074eaecf 100644 --- a/api-reference/v1.0/api/group_resetunseencount.md +++ b/api-reference/v1.0/api/group_resetunseencount.md @@ -14,6 +14,7 @@ POST /groups//microsoft.graph.resetUnseenCount | Authorization | string | Bearer . Required. | ### Request body +Do not supply a request body for this method. ### Response If successful, this method returns `200, OK` response code. It does not return anything in the response body. @@ -27,10 +28,9 @@ Here is an example of the request. "name": "group_resetunseencount" }--> ```http -POST https://graph.microsoft.com/v1.0/groups//resetUnseenCount +POST https://graph.microsoft.com/v1.0/groups//microsoft.graph.resetUnseenCount ``` -##### Response ##### Response Here is an example of the response. \ No newline at end of file +}--> diff --git a/api-reference/v1.0/api/item_invite.md b/api-reference/v1.0/api/item_invite.md new file mode 100644 index 0000000000000..98c3043419afa --- /dev/null +++ b/api-reference/v1.0/api/item_invite.md @@ -0,0 +1,136 @@ +# Send a sharing invitation + +Sends a sharing invitation to an existing item. A sharing invitation creates a unique sharing link and sends an email to the recipient of the invitation that includes the sharing link. + +### Prerequisites +One of the following **scopes** is required to execute this API: + + * Files.ReadWrite + +### HTTP request + +```http +POST /drive/root/Microsoft.Graph.invite +POST /drive/items//Microsoft.Graph.invite +POST /drives//root/Microsoft.Graph.invite + +``` + +### Request headers +| Name | Type | Description| +|:---------------|:--------|:----------| +| Authorization | string | Bearer . Required. | + + +### Request body +In the request body, provide a JSON object with the following parameters. + +| Parameter | Type |Description| +|:---------------|:--------|:----------| +|recipients|recipients|A list of recipient email addresses for the sharing invitation.| +|message|String|A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.| +|requireSignIn|Boolean|Specifies where the recipient of the invitation is required to sign-in to view the shared item.| +|sendInvitation|Boolean|Specifies if an email or post is generated (false) or if the permission is just created (true).| +|roles|String|Specify the roles that are be granted to the recipients of the sharing invitation.| + +### Response +If successful, this method returns `200 OK` response code and [permission](../resources/permission.md) collection object in the response body. + +### Example +Here is an example of how to call this API. +##### Request +Here is an example of the request. + +```http +POST https://graph.microsoft.com/v1.0/drive/root/Microsoft.Graph.invite +Content-type: application/json +Content-length: 313 + +{ + "recipients": [ + { + "email": "email-value", + "alias": "alias-value", + "objectId": "objectId-value", + "permissionIdentityType": "permissionIdentityType-value" + } + ], + "message": "message-value", + "requireSignIn": true, + "sendInvitation": true, + "roles": [ + "roles-value" + ] +} +``` + +##### Response +Here is an example of the response. + +```http +HTTP/1.1 200 OK +Content-type: application/json +Content-length: 939 + +{ + "value": [ + { + "grantedTo": { + "application": { + "displayName": "displayName-value", + "id": "id-value" + }, + "device": { + "displayName": "displayName-value", + "id": "id-value" + }, + "user": { + "displayName": "displayName-value", + "id": "id-value" + } + }, + "id": "id-value", + "invitation": { + "email": "email-value", + "redeemedBy": "redeemedBy-value", + "signInRequired": true + }, + "inheritedFrom": { + "driveId": "driveId-value", + "id": "id-value", + "path": "path-value" + }, + "link": { + "application": { + "displayName": "displayName-value", + "id": "id-value" + }, + "type": "type-value", + "webUrl": "webUrl-value" + }, + "roles": [ + "roles-value" + ] + } + ] +} +``` + + + + diff --git a/api-reference/v1.0/api/item_post_permissions.md b/api-reference/v1.0/api/item_post_permissions.md deleted file mode 100644 index bfd7827f8eff5..0000000000000 --- a/api-reference/v1.0/api/item_post_permissions.md +++ /dev/null @@ -1,101 +0,0 @@ -# Create permission - -Use this API to create a new permission. -### Prerequisites -One of the following **scopes** is required to execute this API: - - * Files.ReadWrite - -### HTTP request - -```http -POST /drive/root/permissions -POST /drive/items//permissions -POST /drives//root/permissions - -``` - -### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | - -### Request body -In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. - - -### Response -If successful, this method returns `201, Created` response code and [permission](../resources/permission.md) object in the response body. - -### Example -##### Request -Here is an example of the request. - -```http -POST https://graph.microsoft.com/v1.0/drive/root -``` -In the request body, supply a JSON representation of the [permission](../resources/permission.md) object. -##### Response -Here is an example of the response. - -```http -HTTP/1.1 201 Created -Content-type: application/json -Content-length: 762 - -{ - "grantedTo": { - "application": { - "displayName": "displayName-value", - "id": "id-value" - }, - "device": { - "displayName": "displayName-value", - "id": "id-value" - }, - "user": { - "displayName": "displayName-value", - "id": "id-value" - } - }, - "id": "id-value", - "invitation": { - "email": "email-value", - "redeemedBy": "redeemedBy-value", - "signInRequired": true - }, - "inheritedFrom": { - "driveId": "driveId-value", - "id": "id-value", - "path": "path-value" - }, - "link": { - "application": { - "displayName": "displayName-value", - "id": "id-value" - }, - "type": "type-value", - "webUrl": "webUrl-value" - }, - "roles": [ - "roles-value" - ] -} -``` - - - \ No newline at end of file diff --git a/api-reference/v1.0/api/itemattachment_delete.md b/api-reference/v1.0/api/itemattachment_delete.md index 7fbb177c2924b..f3ff674d9fd8c 100644 --- a/api-reference/v1.0/api/itemattachment_delete.md +++ b/api-reference/v1.0/api/itemattachment_delete.md @@ -4,8 +4,8 @@ Delete itemAttachment. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.ReadWrite* -* If accessing attachments in Events: *Calendars.ReadWrite* +* If accessing attachments in Messages: _Mail.ReadWrite_ +* If accessing attachments in Events: _Calendars.ReadWrite_ ### HTTP request diff --git a/api-reference/v1.0/api/itemattachment_get.md b/api-reference/v1.0/api/itemattachment_get.md index b93f84cbcf5bd..99c07715efe2d 100644 --- a/api-reference/v1.0/api/itemattachment_get.md +++ b/api-reference/v1.0/api/itemattachment_get.md @@ -4,8 +4,8 @@ Retrieve the properties and relationships of itemattachment object. ### Prerequisites One of the following **scopes** is required to execute this API: -* If accessing attachments in Messages: *Mail.Read* -* If accessing attachments in Events: *Calendars.Read* +* If accessing attachments in Messages: _Mail.Read_ +* If accessing attachments in Events: _Calendars.Read_ ### HTTP request diff --git a/api-reference/v1.0/api/message_copy.md b/api-reference/v1.0/api/message_copy.md index 4fbd1c5a9932f..623cf27dfaaea 100644 --- a/api-reference/v1.0/api/message_copy.md +++ b/api-reference/v1.0/api/message_copy.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_createforward.md b/api-reference/v1.0/api/message_createforward.md index 194d87dc30916..a8b552b2ff3c9 100644 --- a/api-reference/v1.0/api/message_createforward.md +++ b/api-reference/v1.0/api/message_createforward.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_createreply.md b/api-reference/v1.0/api/message_createreply.md index 69b31484f03b1..626ed55a79861 100644 --- a/api-reference/v1.0/api/message_createreply.md +++ b/api-reference/v1.0/api/message_createreply.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_createreplyall.md b/api-reference/v1.0/api/message_createreplyall.md index 15ecf97b538c7..21fe08910e1fb 100644 --- a/api-reference/v1.0/api/message_createreplyall.md +++ b/api-reference/v1.0/api/message_createreplyall.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_delete.md b/api-reference/v1.0/api/message_delete.md index 7c746873697c6..edb692ee02120 100644 --- a/api-reference/v1.0/api/message_delete.md +++ b/api-reference/v1.0/api/message_delete.md @@ -2,8 +2,7 @@ Delete message. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_forward.md b/api-reference/v1.0/api/message_forward.md index 1ba8e40093ddb..d9cdb936214b0 100644 --- a/api-reference/v1.0/api/message_forward.md +++ b/api-reference/v1.0/api/message_forward.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Send* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_get.md b/api-reference/v1.0/api/message_get.md index fd7238690fe1a..d9a64d1a1face 100644 --- a/api-reference/v1.0/api/message_get.md +++ b/api-reference/v1.0/api/message_get.md @@ -2,8 +2,7 @@ Retrieve the properties and relationships of message object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Read* +One of the following **scopes** is required to execute this API: _Mail.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_list_attachments.md b/api-reference/v1.0/api/message_list_attachments.md index 7bc29ef0d0f01..4dabafc861f1a 100644 --- a/api-reference/v1.0/api/message_list_attachments.md +++ b/api-reference/v1.0/api/message_list_attachments.md @@ -2,8 +2,7 @@ Retrieve a list of attachment objects. ### Prerequisites -One of the following **scopes** is required to execute this API: \ -*Mail.Read* +One of the following **scopes** is required to execute this API: _Mail.Read_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_move.md b/api-reference/v1.0/api/message_move.md index 048f5e0281c5f..90956f4526abc 100644 --- a/api-reference/v1.0/api/message_move.md +++ b/api-reference/v1.0/api/message_move.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_post_attachments.md b/api-reference/v1.0/api/message_post_attachments.md index f316f05c34768..d04fadaa5f236 100644 --- a/api-reference/v1.0/api/message_post_attachments.md +++ b/api-reference/v1.0/api/message_post_attachments.md @@ -2,8 +2,7 @@ Use this API to create a new Attachment. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_reply.md b/api-reference/v1.0/api/message_reply.md index 53762dd316555..f03673a45d662 100644 --- a/api-reference/v1.0/api/message_reply.md +++ b/api-reference/v1.0/api/message_reply.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Send* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_replyall.md b/api-reference/v1.0/api/message_replyall.md index dda50a7920513..29a16326c698f 100644 --- a/api-reference/v1.0/api/message_replyall.md +++ b/api-reference/v1.0/api/message_replyall.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Send* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_send.md b/api-reference/v1.0/api/message_send.md index c344bb9478f59..db00a7981566e 100644 --- a/api-reference/v1.0/api/message_send.md +++ b/api-reference/v1.0/api/message_send.md @@ -2,8 +2,7 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.Send* +One of the following **scopes** is required to execute this API: _Mail.Send_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/message_update.md b/api-reference/v1.0/api/message_update.md index fa965a01eed46..ddb1715fe638d 100644 --- a/api-reference/v1.0/api/message_update.md +++ b/api-reference/v1.0/api/message_update.md @@ -2,8 +2,7 @@ Update the properties of message object. ### Prerequisites -One of the following **scopes** is required to execute this API: -*Mail.ReadWrite* +One of the following **scopes** is required to execute this API: _Mail.ReadWrite_ ### HTTP request ```http diff --git a/api-reference/v1.0/api/post_forward.md b/api-reference/v1.0/api/post_forward.md index 1485e6f46ab03..7cf228b232862 100644 --- a/api-reference/v1.0/api/post_forward.md +++ b/api-reference/v1.0/api/post_forward.md @@ -2,7 +2,11 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: + +* Group.ReadWrite +* Group.Readwrite.All + ### HTTP request ```http @@ -11,9 +15,9 @@ POST /groups//conversations//threads//posts//microsoft.graph.for ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, provide a JSON object with the following parameters. @@ -21,7 +25,7 @@ In the request body, provide a JSON object with the following parameters. | Parameter | Type |Description| |:---------------|:--------|:----------| |comment|String|| -|toRecipients|Recipient|| +|toRecipients|Collection([recipient](../resources/recipient.md))|| ### Response If successful, this method returns `200, OK` response code. It does not return anything in the response body. @@ -52,7 +56,6 @@ Content-length: 166 } ``` -##### Response ##### Response Here is an example of the response. ```http @@ -12,9 +16,9 @@ GET /groups//conversations//threads//posts//attachments ### Optional query parameters This method supports the [OData Query Parameters](http://graph.microsoft.io/docs/overview/query_parameters) to help customize the response. ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body Do not supply a request body for this method. @@ -46,14 +50,13 @@ Content-length: 215 "value": [ { "@odata.type": "#Microsoft.OutlookServices.FileAttachment", + "id": "id-value", "contentType": "contentType-value", "contentLocation": "contentLocation-value", "contentBytes": "contentBytes-value", "contentId": "null", "lastModifiedDateTime": "datetime-value", - "id": "id-value", "isInline": false, - "isContactPhoto": false, "name": "name-value", "size": 99 } diff --git a/api-reference/v1.0/api/post_post_attachments.md b/api-reference/v1.0/api/post_post_attachments.md index cadab89d11ca3..cc51876721ce4 100644 --- a/api-reference/v1.0/api/post_post_attachments.md +++ b/api-reference/v1.0/api/post_post_attachments.md @@ -2,7 +2,10 @@ Use this API to create a new Attachment. ### Prerequisites -One of the following **scopes** is required to execute this API: _Groups.ReadWrite_ +One of the following **scopes** is required to execute this API: + +* Group.Readwrite.All + ### HTTP request ```http @@ -11,9 +14,9 @@ POST /groups//conversations//threads//posts//attachments ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, supply a JSON representation of [Attachment](../resources/attachment.md) object. diff --git a/api-reference/v1.0/api/post_reply.md b/api-reference/v1.0/api/post_reply.md index c2bb8c509ce02..fca6dea78eb3f 100644 --- a/api-reference/v1.0/api/post_reply.md +++ b/api-reference/v1.0/api/post_reply.md @@ -2,7 +2,10 @@ ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: + +* Group.Readwrite.All + ### HTTP request ```http @@ -11,16 +14,16 @@ POST /groups//conversations//threads//posts//microsoft.graph.rep ``` ### Request headers -| Name | Type | Description| -|:---------------|:--------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, provide a JSON object with the following parameters. | Parameter | Type |Description| |:---------------|:--------|:----------| -|post|Post|| +|post|[post](../resources/post.md)|| ### Response If successful, this method returns `200, OK` response code. It does not return anything in the response body. diff --git a/api-reference/v1.0/api/post_update.md b/api-reference/v1.0/api/post_update.md index 7155289e04a5f..c43a2339f20c9 100644 --- a/api-reference/v1.0/api/post_update.md +++ b/api-reference/v1.0/api/post_update.md @@ -2,7 +2,10 @@ Update the properties of post object. ### Prerequisites -One of the following **scopes** is required to execute this API: +One of the following **scopes** is required to execute this API: + +* Group.Readwrite.All + ### HTTP request ```http @@ -10,27 +13,18 @@ PATCH /groups//threads//posts/ PATCH /groups//conversations//threads//posts/ ``` ### Request headers -| Name | Type | Description| -|:-----------|:------|:----------| -| Authorization | string | Bearer . Required. | +| Header | Value | +|:---------------|:--------| +| Authorization | Bearer . Required. | ### Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. | Property | Type |Description| |:---------------|:--------|:----------| -|body|ItemBody|| +|body|[itemBody](../resources/itemBody.md)|| |categories|String|| -|changeKey|String|| -|conversationId|String|| -|conversationThreadId|String|| -|createdDateTime|DateTimeOffset|| -|from|Recipient|| -|hasAttachments|Boolean|| -|lastModifiedDateTime|DateTimeOffset|| -|newParticipants|Recipient|| -|receivedDateTime|DateTimeOffset|| -|sender|Recipient|| +|newParticipants|[recipient](../resources/recipient.md)|| ### Response If successful, this method returns a `200 OK` response code and updated [post](../resources/post.md) object in the response body. diff --git a/api-reference/v1.0/api/thumbnailset_delete.md b/api-reference/v1.0/api/thumbnailset_delete.md index eea9e5522b497..75a73d0fa7c90 100644 --- a/api-reference/v1.0/api/thumbnailset_delete.md +++ b/api-reference/v1.0/api/thumbnailset_delete.md @@ -39,7 +39,7 @@ Here is an example of the request. "name": "delete_thumbnailset" }--> ```http -DELETE https://graph.microsoft.com/beta/drive/root/thumbnails/ +DELETE https://graph.microsoft.com/v1.0/drive/root/thumbnails/ ``` ##### Response Here is an example of the response. diff --git a/api-reference/v1.0/api/thumbnailset_get.md b/api-reference/v1.0/api/thumbnailset_get.md index a742bfe1abdbd..82990075cca99 100644 --- a/api-reference/v1.0/api/thumbnailset_get.md +++ b/api-reference/v1.0/api/thumbnailset_get.md @@ -37,7 +37,7 @@ Here is an example of the request. "name": "get_thumbnailset" }--> ```http -GET https://graph.microsoft.com/beta/drive/root/thumbnails/ +GET https://graph.microsoft.com/v1.0/drive/root/thumbnails/ ``` ##### Response Here is an example of the response. diff --git a/api-reference/v1.0/api/thumbnailset_update.md b/api-reference/v1.0/api/thumbnailset_update.md index 20aae5f663450..5ba103876a300 100644 --- a/api-reference/v1.0/api/thumbnailset_update.md +++ b/api-reference/v1.0/api/thumbnailset_update.md @@ -42,7 +42,7 @@ Here is an example of the request. "name": "update_thumbnailset" }--> ```http -PATCH https://graph.microsoft.com/beta/drive/root/thumbnails/ +PATCH https://graph.microsoft.com/v1.0/drive/root/thumbnails/ Content-type: application/json Content-length: 456 diff --git a/api-reference/v1.0/resources/driveitem.md b/api-reference/v1.0/resources/driveitem.md index 2fe122b52eb1c..3e5996c8e9609 100644 --- a/api-reference/v1.0/resources/driveitem.md +++ b/api-reference/v1.0/resources/driveitem.md @@ -10,7 +10,7 @@ For example, if an item behaves as a [folder](folder.md), it will have the **fol | [Get item](../api/item_get.md) | [driveitem](driveitem.md) | Read properties and relationships of item object. | | [Create item](../api/item_post_children.md) | [driveitem](driveitem.md) | Create a new item by posting to the children collection. | | [List children](../api/item_list_children.md) | [driveitem](driveitem.md) collection | Get a children object collection. | -| [Create permission](../api/item_post_permissions.md) | [permission](permission.md) | Create a new permission by posting to the permissions collection. | +| [Create permission](../api/item_invite.md) | [permission](permission.md) | Create a new permission by sending a sharing invitation. | | [List permissions](../api/item_list_permissions.md) | [permission](permission.md) collection | Get a permission object collection. | | [List thumbnails](../api/item_list_thumbnails.md) | [thumbnailSet](thumbnailset.md) collection | Get a thumbnailSet object collection. | | [Update](../api/item_update.md) | [driveitem](driveitem.md) | Update item object. | @@ -22,6 +22,7 @@ For example, if an item behaves as a [folder](folder.md), it will have the **fol | [Download content](../api/item_downloadcontent.md)| See API for details| Download the contents for an item.| | [Upload content](../api/item_uploadcontent.md)| See API for details| The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call.| + ### Properties | Property | Type |Description| |:---------------|:--------|:----------| diff --git a/content/authorization/converged_auth.md b/content/authorization/converged_auth.md index 21ebff5e19c5f..d7ecb39d8a244 100644 --- a/content/authorization/converged_auth.md +++ b/content/authorization/converged_auth.md @@ -11,7 +11,7 @@ ##Signing in Microsoft account and Azure AD users with a single authentication model -The converged authentication authentication model preview enables you to create apps that accept both work and school (Azure AD) as well as personal (Microsoft account) identities. +The converged authentication model preview enables you to create apps that accept both work and school (Azure AD) as well as personal (Microsoft account) identities. In the past, an app developer who wanted to support both Microsoft accounts and Azure Active Directory was required to integrate with two completely separate systems. Now you can build apps using the converged authentication model, which allows you to sign users in with both types of accounts. One simple process allows you to immediately reach an audience that spans millions of users with both personal and work/school accounts. diff --git a/content/overview/overview.md b/content/overview/overview.md index 662b489dc89cb..607d7497a1684 100644 --- a/content/overview/overview.md +++ b/content/overview/overview.md @@ -34,7 +34,7 @@ The following are some examples of common queries using Microsoft Graph API: | GET my calendar | `https://graph.microsoft.com/v1.0/me/calendar` | | GET my manager | `https://graph.microsoft.com/v1.0/me/manager` | | GET last user to modify file foo.txt | `https://graph.microsoft.com/v1.0/me/drive/root/items/foo.txt/lastModifiedByUser` | -| GET unified groups I’m member of| `https://graph.microsoft.com/v1.0/me/memberOf?$/microsoft.graph.group?$filter=groupTypes/any(a:a eq 'unified')` | +| GET unified groups I’m member of| `https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a eq 'unified')` | | GET users in my organization | `https://graph.microsoft.com/v1.0/users` | | GET group conversations | `https://graph.microsoft.com/v1.0/groups//conversations` | | GET people related to me | `https://graph.microsoft.com/beta/me/people` | diff --git a/content/walkthroughs/iOS.md b/content/walkthroughs/iOS.md index e89c891141f57..7702f728b5bea 100644 --- a/content/walkthroughs/iOS.md +++ b/content/walkthroughs/iOS.md @@ -1,12 +1,9 @@ # Call Microsoft Graph in an iOS App -In this article we look at the minimum tasks required to connect your application to Office 365 and calling the Microsoft Graph API. We use code from the [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified-API-Connect) to explain the main concepts that you have to implement in your app. This samples covers the core fundamentals for authenticating with Microsoft Azure Active Directory (AAD), and making a simple service call against the Office 365 mail service using the Microsoft Graph API (sending a mail). It's recommended that you clone or download the project from this repository to accompany this article. +In this article we look at the minimum tasks required to connect your application to Office 365 and calling the Microsoft Graph API. We use code from the [O365-iOS-Microsoft-Graph-Connect](https://github.com/OfficeDev/O365-iOS-Microsoft-Graph-Connect) to explain the main concepts that you have to implement in your app. This samples covers the core fundamentals for authenticating with Microsoft Azure Active Directory (AAD), and making a simple service call against the Office 365 mail service using the Microsoft Graph API (sending a mail). It's recommended that you clone or download the project from this repository to accompany this article. -The following is the screenshot of the send mail page. -![Office 365 iOS Unified API Connect sample screenshot](./images/iOSConnect.png) - -This article references the [Microsoft Azure Active Directory Authentication Library (ADAL) for iOS and OSX](https://github.com/AzureAD/azure-activedirectory-library-for-objc), and the [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified-API-Connect) sample authenticates using this library. See this repository for more information on usage and implementation in your iOS project. +This article references the [Microsoft Azure Active Directory Authentication Library (ADAL) for iOS and OSX](https://github.com/AzureAD/azure-activedirectory-library-for-objc), and the [O365-iOS-Microsoft-Graph-Connect](https://github.com/OfficeDev/O365-iOS-Microsoft-Graph-Connect) sample authenticates using this library. See this repository for more information on usage and implementation in your iOS project. ## Overview @@ -24,7 +21,7 @@ To call the Microsoft Graph API, your iOS app must complete the following: Before you can start working with Office 365, you need to register your application and set permissions to use Microsoft Graph services. With just a few clicks, you can register your application to access a user's work or school account using the [Application Registration Tool](https://dev.office.com/app-registration). To manage it you will need to go to the [Microsoft Azure Management portal](https://manage.windowsazure.com) -Alternatively, see the section **Register your native app with the Azure Management Portal** in the article [Manually register your app with Azure AD so it can access Office 365 APIs](https://msdn.microsoft.com/en-us/office/office365/howto/add-common-consent-manually) for instructions on how to manually register the app, keep in mind the following details: +Alternatively, see the section **Register your native app with the Azure Management Portal** in the article [Manually register your app with Azure AD so it can access Office 365 APIs](https://msdn.microsoft.com/office/office365/howto/add-common-consent-manually) for instructions on how to manually register the app, keep in mind the following details: * For the registration you'll need to supply a redirect URI. This a required value that specifies where a user will be redirected after a successful authentication attempt. If you don't specify the correct redirect URI, the authentication request will fail. * In the registration, the app must be granted the **Send mail as signed-in user permission** for the **Microsoft Graph**. @@ -57,7 +54,7 @@ Then initialize it with the location of the authority ("https://login.microsofto self.context = [ADAuthenticationContext authenticationContextWithAuthority:self.authority]; -In the [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified-API-Connect) sample we created a singleton authentication class (**AuthenticationManager**) for demonstration purposes that is initialized with the authority and required parameters. Again, this class is merely an example on how to approach the authentication workflow. A code segment of interest: +In the [O365-iOS-Microsoft-Graph-Connect](https://github.com/OfficeDev/O365-iOS-Microsoft-Graph-Connect) sample we created a singleton authentication class (**AuthenticationManager**) for demonstration purposes that is initialized with the authority and required parameters. Again, this class is merely an example on how to approach the authentication workflow. A code segment of interest: @@ -98,7 +95,7 @@ token in the cache to authenticate client requests. This will result in a call t With an access token, your app can make authenticated requests to the Microsoft Graph API. Your app must append the access token to the HTTP request header under **Authorization**. -The [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified-API-Connect) sample sends an email using the sendMail endpoint in the Microsoft Graph API. Again, our in our sample we created a singleton authentication class (AuthenticationManager) that is initialized with the access token. We'll need the access token to construct our request. +The [O365-iOS-Microsoft-Graph-Connect](https://github.com/OfficeDev/O365-iOS-Microsoft-Graph-Connect) sample sends an email using the sendMail endpoint in the Microsoft Graph API. Again, our in our sample we created a singleton authentication class (AuthenticationManager) that is initialized with the access token. We'll need the access token to construct our request. @@ -110,7 +107,7 @@ The [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified NSData *postData = [self mailContent]; //Microsoft Graph API endpoint for sending mail - NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:[NSURL URLWithString:@"https://graph.microsoft.com/beta/me/sendMail"]]; + NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:[NSURL URLWithString:@"https://graph.microsoft.com/v1.0/me/microsoft.graph.sendmail"]]; [request setHTTPMethod:@"POST"]; [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"]; @@ -135,7 +132,7 @@ As you can see, the response is handled with the NSURLConnection delegates, name ## Next Steps -If access token is expired, or about to expire, you can use ADAuthenticationContext’s **acquireTokenSilentWithResource:clientId:redirectUri:completionBlock:** to acquire a new access token. It's usage is covered in the [O365-iOS-Unified-API-Connect](https://github.com/OfficeDev/O365-iOS-Unified-API-Connect) sample. Also, you can find the code to clear your token cache and stored cookies. +If access token is expired, or about to expire, you can use ADAuthenticationContext’s **acquireTokenSilentWithResource:clientId:redirectUri:completionBlock:** to acquire a new access token. It's usage is covered in the [O365-iOS-Microsoft-Graph-Connect](https://github.com/OfficeDev/O365-iOS-Microsoft-Graph-Connect) sample. Also, you can find the code to clear your token cache and stored cookies. The Microsoft Graph API is a very powerful, unifiying API that can be used to interact with all kinds of Microsoft data. Check out the [API reference](http://graph.microsoft.io/docs/api-reference/v1.0) to explore what else you can accomplish with the Microsoft Graph API.