{"id":3367,"date":"2019-08-30T00:08:51","date_gmt":"2019-08-30T07:08:51","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=3367"},"modified":"2019-08-30T00:08:51","modified_gmt":"2019-08-30T07:08:51","slug":"breaking-changes-application-and-serviceprincipal-api-updates-in-microsoft-graph-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/breaking-changes-application-and-serviceprincipal-api-updates-in-microsoft-graph-beta\/","title":{"rendered":"Breaking changes: Application and ServicePrincipal API updates in Microsoft Graph beta"},"content":{"rendered":"

We’re updating the\u00a0application,<\/a><\/u>\u00a0servicePrincipal<\/a><\/u> and oAuth2PermissionGrant<\/a>\u00a0Microsoft Graph APIs in public preview (beta). These changes will roll out in phases over the next few weeks.<\/p>\n

Changes to properties<\/h2>\n\n\n\n\n\n\n\n\n
Change<\/strong><\/td>\nCall to action<\/strong><\/td>\n<\/tr>\n<\/thead>\n
The orgRestrictions\u00a0<\/strong>property\u00a0will be removed from the\u00a0application<\/a> resource. This property was marked as “Reserved for future use” and Azure AD ignores the value of this property today.<\/td>\nWriting to this property has no effect today. If you read this property today, update your clients as needed to handle this scenario.<\/td>\n<\/tr>\n
The startTime <\/strong>and expiryTime\u00a0<\/strong>properties\u00a0will be deleted from oAuth2PermissonGrant<\/a>. Azure AD ignores the value of these properties today.<\/td>\nWriting to these properties has no effect today. If you read these properties today, update your clients as needed to handle this scenario.<\/td>\n<\/tr>\n
The errorUrl\u00a0<\/strong>property\u00a0will be deleted from servicePrincipal<\/a>. Azure AD ignores the value of this property today.<\/td>\nWriting to this property has no effect today. Update your clients as needed to handle this scenario.<\/td>\n<\/tr>\n
The signInAudience\u00a0<\/strong>property will be deleted from servicePrincipal<\/a>. Azure AD ignores the value of this property today.<\/td>\nIf you read this property today, update your clients as needed to handle this scenario.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Changes to methods<\/h2>\n
You can no longer use a PATCH operation on the\u00a0application<\/a>\u00a0or\u00a0 servicePrincipal<\/a> objects to update\u00a0passwordCredentials<\/a>.<\/u>\u00a0You can use the addPassword<\/a>\u00a0and removePassword methods to update the password for an application or a servicePrincipal.<\/div>\n

addPassword<\/strong><\/p>\n

Request – application<\/p>\n

POST https:\/\/graph.microsoft.com\/beta\/applications\/{id}\/addPassword\n{\n    \"passwordCredential\": {\n        \"displayName\": \"Password friendly name\"\n    }\n}<\/pre>\n
Response – application<\/p>\n
{\n    \"@odata.context\": \"https:\/\/graph.microsoft.com\/beta\/$metadata#microsoft.graph.passwordCredential\",\n    \"customKeyIdentifier\": \"guid\",\n    \"endDateTime\": \"timestamp\",\n    \"keyId\": \"guid\",\n    \"startDateTime\": \"timestamp\",\n    \"secretText\": \"string\"\n    \"hint\": \"string\",\n    \"displayName\": \"string\"\n}<\/pre>\n
 <\/p>\n
Request – servicePrincipal<\/p>\n
POST https:\/\/graph.microsoft.com\/beta\/servicePrincipals\/{id}\/addPassword\n{ \n    \"passwordCredential\": { \n        \"displayName\": \"Password friendly name\" \n    } \n}<\/pre>\n
Response – servicePrincipal<\/p>\n
{\n    \"@odata.context\": \"https:\/\/graph.microsoft.com\/beta\/$metadata#microsoft.graph.passwordCredential\",\n    \"customKeyIdentifier\": \"guid\",\n    \"endDateTime\": \"timestamp\",\n    \"keyId\": \"guid\",\n    \"startDateTime\": \"timestamp\",\n    \"secretText\": \"string\"\n    \"hint\": \"string\",\n    \"displayName\": \"string\"\n}<\/pre>\n
 <\/p>\n
removePassword<\/strong><\/p>\n
Request – application<\/p>\n
POST\u202f https:\/\/graph.microsoft.com\/beta\/applications\/{id}\/removePassword\n{\n    \"keyId\": \"key id\"\n}<\/pre>\n
Response – application<\/p>\n
204 No content<\/pre>\n
 <\/p>\n
Request – servicePrincipal<\/p>\n
POST https:\/\/graph.microsoft.com\/beta\/servicePrincipals\/{id}\/removePassword\n{\n    \"keyId\": \"key id\"\n}<\/pre>\n
Response – servicePrincipal<\/p>\n
204 No content<\/pre>\n
<\/h2>\n
Tell us what you think<\/h2>\n
We welcome your feedback on\u00a0UserVoice<\/a><\/u>. If you have questions, reach out to\u00a0us on\u00a0Stack Overflow<\/a><\/u>.<\/p>\n
-The Microsoft Identity Platform Team<\/p>\n","protected":false},"excerpt":{"rendered":"
Breaking changes: Application and ServicePrincipal API updates in Microsoft Graph beta<\/p>\n","protected":false},"author":69077,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3,5],"tags":[22],"class_list":["post-3367","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","category-microsoft-identity-platform","tag-azure-ad"],"acf":[],"blog_post_summary":"
Breaking changes: Application and ServicePrincipal API updates in Microsoft Graph beta<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3367","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=3367"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/3367\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=3367"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=3367"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=3367"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}