Main (#1726)

* Initialize open publishing repository: https://github.com/OneDrive/onedrive-api-docs of branch master

* Initialize open publishing repository: https://github.com/OneDrive/onedrive-api-docs of branch master

* update with existing .openpublishing.publish.config.json

* [BrokenLinksH2] (#1619)

* [BrokenLinksH2]

* broken links

* Update description rely on AI ability (#1717)

Co-authored-by: Docs Allowlist Management <docs-allowlist-mgmt@microsoft.com>

* Update description rely on AI ability (#1718)

Co-authored-by: Docs Allowlist Management <docs-allowlist-mgmt@microsoft.com>

* Update description rely on AI ability (#1719)

Co-authored-by: Docs Allowlist Management <docs-allowlist-mgmt@microsoft.com>

---------

Co-authored-by: daspek <daspek@hotmail.com>
Co-authored-by: VesaJuvonen <vesa.juvonen@hotmail.com>
Co-authored-by: Chris Hackmann <chackman@users.noreply.github.com>
Co-authored-by: Mohit Patel <103079000+mohitp930@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Docs Allowlist Management <docs-allowlist-mgmt@microsoft.com>

Author: 7 people

.openpublishing.publish.config.json

@@ -20,6 +20,7 @@
   "notification_subscribers": [
     "dspektor@microsoft.com"
   ],
+  "sync_notification_subscribers": null,
   "branches_to_filter": [],
   "git_repository_url_open_to_public_contributors": "https://github.com/OneDrive/onedrive-api-docs",
   "git_repository_branch_open_to_public_contributors": "live",
@@ -30,7 +31,7 @@
     {
       "path_to_root": "_themes",
       "url": "https://github.com/Microsoft/templates.docs.msft",
-      "branch": "master",
+      "branch": "main",
       "branch_mapping": {}
     }
   ],

docs/rest-api/concepts/migrating-from-live-sdk.md

@@ -10,7 +10,7 @@ ms.localizationpriority: Medium
 If you are using the Live SDK or Live Connect APIs to connect to profile, calendar, contacts, or files, your app needs to be updated to maintain functionality.
 
 Live SDK and Live Connect APIs have been marked as deprecated for over a year. 
-As announced on the [Office Developer blog](https://dev.office.com/blogs), these APIs are now end of life and will no longer be available after **November 1, 2018**.
+As announced on the [Office Developer blog](https://devblogs.microsoft.com/microsoft365dev/), these APIs are now end of life and will no longer be available after **November 1, 2018**.
 
 Profile and contacts data will no longer be available from the Live Connect APIs as of **Decmeber 1, 2017**.
 Calendar data has not been available from Live Connect since **June 2017**.
@@ -24,10 +24,10 @@ To continue to integrate with Microsoft services, developers must update their a
 
 Similar to the capabilities of Live Connect, Microsoft Graph has a number of resources available depending on the type of user data your app interacts with:
 
-* [Microsoft account authentication](https://developer.microsoft.com/en-us/graph/docs/concepts/auth_overview)
+* [Microsoft account authentication](/graph/auth/)
 * [OneDrive files](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/onedrive)
 * [Outlook calendar](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/calendar)
-* [Outlook messages](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/mail_api_overview)
+* [Outlook messages](/graph/outlook-mail-concept-overview)
 * [Personal contacts](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/contact)
 * [Profile and Identity API](https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/users)
 
@@ -41,7 +41,7 @@ Microsoft Graph uses a different set of permission scopes than Live Connect.
 To access the Microsoft Graph APIs, your app will need to switch permission scopes.
 This requires your app to prompt the user for consent to sign in and consent to the new permissions.
 
-See the [Microsoft Graph permission reference](https://developer.microsoft.com/en-us/graph/docs/concepts/permissions_reference) for the complete details.
+See the [Microsoft Graph permission reference](/graph/permissions-reference) for the complete details.
 
 | Live Connect Scope      | Microsoft Graph Permission | Description                                                                                                                     |
 | ----------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
@@ -84,7 +84,7 @@ You will need to use the Microsoft Graph SDK or update your JSON mapping to use
 [1]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
 [2]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/photo/$value&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
 [user]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/users
-[user-photo]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/profilephoto_get
+[user-photo]: /graph/api/profilephoto-get
 
 ## Contacts API
 
@@ -102,8 +102,8 @@ You will need to use the Microsoft Graph SDK or update your JSON mapping to use
 
 [3]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/contacts&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
 [4]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/contacts/AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEOAAAiIsqMbYjsT5e-T7KzowPTAAAYbuK-AAA=&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
-[contacts]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_list_contacts
-[create-contact]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_post_contacts
+[contacts]: /graph/api/user-list-contacts
+[create-contact]: /graph/api/user-post-contacts
 
 ## Calendar API
 
@@ -121,9 +121,9 @@ You will need to use the Microsoft Graph SDK or update your JSON mapping to use
 
 [5]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/calendars&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
 [6]: https://developer.microsoft.com/en-us/graph/graph-explorer?request=me/events?$select=subject,body,bodyPreview,organizer,attendees,start,end,location&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com
-[calendars]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_list_calendars
-[events]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_list_events
-[create-event]: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/user_post_events
+[calendars]: /graph/api/user-list-calendars
+[events]: /graph/api/user-list-events
+[create-event]: /graph/api/user-post-events
 
 ## OneDrive REST API
 

docs/rest-api/concepts/working-with-cors.md

@@ -4,7 +4,10 @@ ms.author: JeremyKe
 ms.date: 09/10/2017
 ms.topic: conceptual
 title: CORS support - OneDrive API
-ms.localizationpriority: Medium
+
+localization_priority: Normal
+description: Master OneDrive API with CORS for seamless JavaScript integration. Explore sample code, requests, and file downloads. Boost your app's performance.
+
 ---
 # Using the OneDrive API in JavaScript apps (CORS support)
 

docs/rest-api/getting-started/aad-oauth.md

@@ -36,7 +36,7 @@ You provide an access token for every API call via an HTTP header:
 You access the API by sending HTTP requests to a specific endpoint URL.
 The root URL is based on the host name of the server that serves as the REST endpoint.
 You can use the discovery API to find endpoints for Office 365 services.
-For more information see [Common endpoint discovery tasks using the Discovery Service API](https://msdn.microsoft.com/en-us/office/office365/howto/discover-service-endpoints).
+For more information see [Common endpoint discovery tasks using the Discovery Service API](https://msdn.microsoft.com/office/office365/howto/discover-service-endpoints).
 Your root URL appears in the next example, where `{tenant}` comes from your discovered endpoint URL:
 
 `https://{tenant}-my.sharepoint.com/_api/v2.0/`
@@ -59,7 +59,7 @@ To sign into OneDrive for Business the first time, your app needs the following
 The following steps will walk you through the requests necessary to get all of these values.
 
 The flow follows standard OAuth 2.0 authentication flows and requires calls from a web browser or web-browser control.
-See [Understanding Office 365 app authentication concepts](https://msdn.microsoft.com/en-us/office/office365/howto/common-app-authentication-tasks) for general Office 365 authentication info.
+See [Understanding Office 365 app authentication concepts](https://msdn.microsoft.com/office/office365/howto/common-app-authentication-tasks) for general Office 365 authentication info.
 However, getting all of the required values to use the OneDrive for Business API requires a few additional steps.
 
 The code flow for authentication is a three-step process with separate calls to authenticate and authorize the application and to generate an access token to use the OneDrive API.
@@ -90,7 +90,7 @@ GET https://login.microsoftonline.com/common/oauth2/authorize?response_type=code
 | *response_type* | string | Specifies the requested response type. In an authorization code grant request, the value must be code. |
 | *redirect_uri*  | string | The redirect URL that the browser is sent to when authentication is complete.                          |
 
-**Note** The redirect URI must match one of the redirect URI that you specified in the [Azure Management Portal](https://manage.windowsazure.com/).
+**Note** The redirect URI must match one of the redirect URI that you specified in the [Azure Management Portal](https://portal.azure.com).
 
 #### Response
 
@@ -226,7 +226,7 @@ The request body is a URL encoded string, with the following parameters:
 | *resource*      | string | The resource you want to access. This should be the previously discovered **serviceResourceId** value.                                              |
 
 
-**Note**  The redirect URI must match the the redirect URI that you specified in the [Azure Management Portal](https://manage.windowsazure.com/).
+**Note**  The redirect URI must match the the redirect URI that you specified in the [Azure Management Portal](https://portal.azure.com).
 
 #### Response
 
@@ -244,7 +244,7 @@ If the call is successful, the response body is a JSON string that including `ac
 **Note:** Replace refresh token values that you have previously stored with those returned from subsequent calls to the token service to ensure that your app has a token with the latest expiration.
 
 The value of the **access_token** property can now be used to make authenticated requests to the OneDrive API.
-For more info about refresh tokens, see [Refresh Tokens for Multiple Resources](https://msdn.microsoft.com/en-us/library/azure/dn645538.aspx).
+For more info about refresh tokens, see [Refresh Tokens for Multiple Resources](https://msdn.microsoft.com/library/azure/dn645538.aspx).
 
 **Important:** Treat the values of `access_token` and `refresh_token` in this response as securely as you would a user's password.
 
@@ -278,7 +278,7 @@ The page content will always display a generic error message for the user.
 
 If the user selects not to provide consent to your application, the flow will redirect to your redirect_uri and include the same error parameters.
 
-For more info about handling errors, see [Error Handling in OAuth 2.0](https://msdn.microsoft.com/en-us/library/azure/dn645540.aspx).
+For more info about handling errors, see [Error Handling in OAuth 2.0](https://msdn.microsoft.com/library/azure/dn645540.aspx).
 
 [app-portal]: http://go.microsoft.com/fwlink/p/?LinkId=193157
 
@@ -288,11 +288,11 @@ The following topics contain high-level overviews of other concepts that apply
 to the OneDrive API.
 
 * [Develop with the OneDrive API](../../index.md)
-* [Using Azure Active Directory for authentication](https://azure.microsoft.com/en-us/documentation/articles/web-sites-authentication-authorization/)
+* [Using Azure Active Directory for authentication](https://azure.microsoft.com/documentation/articles/web-sites-authentication-authorization/)
 * [OneDrive authentication and sign-in using Microsoft accounts](msa-oauth.md)
-* [Office 365 authentication concepts](https://msdn.microsoft.com/en-us/office/office365/howto/common-app-authentication-tasks)
-* [OAuth 2.0 in Auzure AD](https://msdn.microsoft.com/en-us/library/azure/dn645545.aspx)
-* [Authorization Code Grant Flow](https://msdn.microsoft.com/en-us/library/azure/dn645542.aspx)
+* [Office 365 authentication concepts](https://msdn.microsoft.com/office/office365/howto/common-app-authentication-tasks)
+* [OAuth 2.0 in Auzure AD](https://msdn.microsoft.com/library/azure/dn645545.aspx)
+* [Authorization Code Grant Flow](https://msdn.microsoft.com/library/azure/dn645542.aspx)
 
 <!-- {
   "type": "#page.annotation",

docs/rest-api/getting-started/app-registration-server.md

@@ -63,33 +63,33 @@ with the name of your Office 365 tenant.
 If you already have an existing Azure AD tenant, you can associate it with
 your Office 365 subscription by following these steps:
 
-1. Sign in to the [Microsoft Azure Management](https://manage.windowsazure.com/)
+1. Sign in to the [Microsoft Azure Management](https://portal.azure.com)
    portal with your existing Azure credentials (for example, your Microsoft ID
    such as user@live.com), and navigate to the **Active Directory** node.
 2. Choose the **Active Directory** node, then choose the **Directory** tab and,
    at the bottom of the screen, choose **New**. In the next dialog box, choose **Use
    existing directory**, select the check box, and then choose the check mark in the
-   lower-right corner. This brings you back to the [Azure Management Portal](https://manage.windowsazure.com/).
+   lower-right corner. This brings you back to the [Azure Management Portal](https://portal.azure.com).
 3. Sign in with your Office 365 subscription information. You will be prompted
    whether to use your directory with Azure.
 4. Choose **Continue** and a screen appears to confirm your action. Now,
    choose **Sign out now**.
-5. Close the browser and open the [portal](https://manage.windowsazure.com/) again.
+5. Close the browser and open the [portal](https://portal.azure.com) again.
    Otherwise, you will get an access denied error.
 6. Sign in again to your Azure subscription (for example, with your Microsoft ID).
    Navigate to the **Active Directory** node and, under **Directory**, you
    should now see your Office 365 subscription.
 
 For more info about setting up an Azure AD tenant, see [Set up Azure Active
-Directory access for your Developer Site](https://msdn.microsoft.com/en-us/office/office365/howto/setup-development-environment#bk_CreateAzureSubscription).
+Directory access for your Developer Site](https://msdn.microsoft.com/office/office365/howto/setup-development-environment#bk_CreateAzureSubscription).
 
 ### 3. Register your app with Azure Active Directory
 
-To authenticate your app, you need to register your app with Azure AD, and provide some details about your app. You can register your app manually by using the [Azure Management Portal](https://manage.windowsazure.com/),
+To authenticate your app, you need to register your app with Azure AD, and provide some details about your app. You can register your app manually by using the [Azure Management Portal](https://portal.azure.com),
 or by using Visual Studio.
 
 To register your app manually, see [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).
+it can access Office 365 APIs](https://msdn.microsoft.com/office/office365/howto/add-common-consent-manually).
 
 To register your app by using Visual Studio, see [Using Visual Studio to
 register your app and add Office 365 APIs](https://msdn.microsoft.com/office/office365/HowTo/adding-service-to-your-Visual-Studio-project).
@@ -102,7 +102,7 @@ your access token.
 as you would a user's password. The secret represents the key to your
 application and, if made available, can be used to impersonate your application.
 
-When you register your app in the [Azure Management Portal](https://manage.windowsazure.com/),
+When you register your app in the [Azure Management Portal](https://portal.azure.com),
 you will need to configure details about your application with the following steps:
 
 1. Specify whether your application is a mobile, desktop, or web application.
@@ -114,7 +114,7 @@ you will need to configure details about your application with the following ste
    tenancy you registered it in, or across multiple tenancies.
 4. For web apps, generate the app secret and its duration.
 5. Specify the permission levels your app requires from the Office 365 API
-   applications in Azure using [app permissions](https://msdn.microsoft.com/office/office365/howto/application-manifest).
+   applications in Azure using [app permissions](/office/office-365-management-api/get-started-with-office-365-management-apis).
    Using OneDrive API or the file picker requires at least **Read user files**. Uploading, editing, or sharing files
    requires the **Read and write user files** permission.
 

docs/rest-api/getting-started/app-registration.md

@@ -4,7 +4,9 @@ ms.author: JeremyKe
 ms.date: 09/10/2017
 ms.topic: conceptual
 title: Create an app with Microsoft Graph - OneDrive API
-ms.localizationpriority: High
+localization_priority: Priority
+description: Learn to Register Your App for OneDrive API with Microsoft Graph. Get an Application ID & Secure Your App. Maximize Features with Azure AD.
+
 ---
 # Registering your app for Microsoft Graph