Updates from: 07/24/2021 03:09:10
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accesspackageassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accesspackageassignmentrequest-post.md
Content-type: application/json
"assignmentPolicyId": "2264bf65-76ba-417b-a27d-54d291f0cbc8", "accessPackageId": "a914b616-e04e-476b-aa37-91038f0b165b" },
- "answers": [{
- "@odata.type": "#microsoft.graph.accessPackageAnswerString",
- "value": "Arizona",
- "answeredQuestion": {
- "id" : "A714EC6F-4EE0-4614-BD81-37E0C5ECBBFF"
+ "answers": [
+ {
+ "@odata.type": "#microsoft.graph.accessPackageAnswerString",
+ "value": "Arizona",
+ "answeredQuestion": {
+ "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion",
+ "id": "A714EC6F-4EE0-4614-BD81-37E0C5ECBBFF"
+ }
+ },
+ {
+ "@odata.type": "#microsoft.graph.accessPackageAnswerString",
+ "value": "Need access to marketing campaign material",
+ "answeredQuestion": {
+ "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
+ "id": "AA615EE9-D9D8-4C03-BE91-BEE37106DEDA"
+ }
}
- }, {
- "@odata.type": "#microsoft.graph.accessPackageAnswerString",
- "value": "Need access to marketing campaign material",
- "answeredQuestion": {
- "id" : "AA615EE9-D9D8-4C03-BE91-BEE37106DEDA"
- }
- }]
+ ]
} ``` # [C#](#tab/csharp)
Content-type: application/json
"requestState": "Submitted", "requestStatus": "Accepted", "isValidationOnly": false,
- "answers": [{
- "@odata.type": "#microsoft.graph.accessPackageAnswerString",
- "value": "Arizona",
- "answeredQuestion": {
- "id" : "A714EC6F-4EE0-4614-BD81-37E0C5ECBBFF",
- "isRequired": false,
- "text": {
- "defaultText": "what state are you from?",
- "localizedTexts": [{
- "text": "¿De qué estado eres?",
- "languageCode": "es"
- }]
- },
- "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion",
- "choices": [{
- "actualValue": "AZ",
- "displayValue": {
- "localizedTexts": [{
- "text": "Arizona",
- "languageCode": "es"
- }]
- }
- }, {
- "actualValue": "CA",
- "displayValue": {
- "localizedTexts": [{
- "text": "California",
- "languageCode": "es"
- }]
- }
- }, {
- "actualValue": "OH",
- "displayValue": {
- "localizedTexts": [{
- "text": "Ohio",
- "languageCode": "es"
- }]
- }
- }],
- "allowsMultipleSelection": false
- }
- }, {
- "@odata.type": "#microsoft.graph.accessPackageAnswerString",
- "value": "Need access to marketing campaign material",
- "answeredQuestion": {
- "id" : "AA615EE9-D9D8-4C03-BE91-BEE37106DEDA",
- "isRequired": false,
- "text": {
- "defaultText": "Who is your manager?",
- "localizedTexts": [{
- "text": "por qué necesita acceso a este paquete",
- "languageCode": "es"
- }]
- },
- "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
- "isSingleLineQuestion": false
+ "answers": [
+ {
+ "@odata.type": "#microsoft.graph.accessPackageAnswerString",
+ "value": "Arizona",
+ "answeredQuestion": {
+ "id": "A714EC6F-4EE0-4614-BD81-37E0C5ECBBFF",
+ "isRequired": false,
+ "text": {
+ "defaultText": "what state are you from?",
+ "localizedTexts": [
+ {
+ "text": "¿De qué estado eres?",
+ "languageCode": "es"
+ }
+ ]
+ },
+ "@odata.type": "#microsoft.graph.accessPackageMultipleChoiceQuestion",
+ "choices": [
+ {
+ "actualValue": "AZ",
+ "displayValue": {
+ "localizedTexts": [
+ {
+ "text": "Arizona",
+ "languageCode": "es"
+ }
+ ]
+ }
+ },
+ {
+ "actualValue": "CA",
+ "displayValue": {
+ "localizedTexts": [
+ {
+ "text": "California",
+ "languageCode": "es"
+ }
+ ]
+ }
+ },
+ {
+ "actualValue": "OH",
+ "displayValue": {
+ "localizedTexts": [
+ {
+ "text": "Ohio",
+ "languageCode": "es"
+ }
+ ]
+ }
+ }
+ ],
+ "allowsMultipleSelection": false
+ }
+ },
+ {
+ "@odata.type": "#microsoft.graph.accessPackageAnswerString",
+ "value": "Need access to marketing campaign material",
+ "answeredQuestion": {
+ "id": "AA615EE9-D9D8-4C03-BE91-BEE37106DEDA",
+ "isRequired": false,
+ "text": {
+ "defaultText": "Who is your manager?",
+ "localizedTexts": [
+ {
+ "text": "por qué necesita acceso a este paquete",
+ "languageCode": "es"
+ }
+ ]
+ },
+ "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
+ "isSingleLineQuestion": false
+ }
}
- }]
+ ]
} ``` ### Example 3: Request a package and provide a justification
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/applications?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_web_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/applications?$search="displayName:Web"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-setverifiedpublisher.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/application-setverifiedpublisher-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [C#](#tab/csharp)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+
v1.0 Application Unsetverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-unsetverifiedpublisher.md
POST https://graph.microsoft.com/beta/applications/{id}/unsetVerifiedPublisher
[!INCLUDE [sample-code](../includes/snippets/objc/application-unsetverifiedpublisher-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [C#](#tab/csharp)
+
+# [Java](#tab/java)
+
v1.0 B2cidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cidentityuserflow-userflowidentityproviders-update.md
PATCH https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_test_signin_sig
Content-type: application/json {
- "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/{id}"
+ "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/{id}",
+ "@odata.type": "#microsoft.graph.identityProvider"
} ``` # [C#](#tab/csharp)
v1.0 B2xidentityuserflow Userflowidentityproviders Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2xidentityuserflow-userflowidentityproviders-update.md
PATCH https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Test/userflow
Content-type: application/json {
- "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/B2X_1_Test"
+ "@odata.id": "https://graph.microsoft.com/beta/identity/identityProviders/B2X_1_Test",
+ "@odata.type": "#microsoft.graph.identityProvider"
} ``` # [C#](#tab/csharp)
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-post.md
The following is an example of the request. For information about how to get a l
> Note: **conversationIdentityType** must be set to `channel` to @mention a channel. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_chatmessage_atmentionchannel"
Content-type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
The following is an example of the request.
> Note: **conversationIdentityType** must be set to `team` to @mention a team. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_chatmessage_atmentionteam"
Content-type: application/json
"reactions": [] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
#### Request The following is an example of the request. For information about how to get a list of tags in a team, see [List teamworkTags](../api/teamworktag-list.md). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_chatmessage_atmentiontag"
Content-type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Conversationthread List Posts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversationthread-list-posts.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /groups/{id}/threads/{id}/posts
-GET /groups/{id}/conversations/{id}/threads/{id}/posts
+GET /groups/{groupId}/threads/{threadId}/posts
+GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
``` ## Optional query parameters
v1.0 Conversationthread Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversationthread-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /groups/{id}/threads/{id}
-PATCH /groups/{id}/conversations/{id}/threads/{id}
+PATCH /groups/{group id}/threads/{thread id}
+PATCH /groups/{group id}/conversations/{conversation id}/threads/{thread id}
``` ## Request headers
In the request body, supply the values for relevant fields that should be update
## Response
-If successful, this method returns a `200 OK` response code and updated [conversationThread](../resources/conversationthread.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an empty object in the response body.
## Example ##### Request Here is an example of the request. # [HTTP](#tab/http) <!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "update_conversationthread" }--> ```http
-PATCH https://graph.microsoft.com/beta/groups/{id}/threads/{id}
+PATCH https://graph.microsoft.com/beta/groups/0fbf2921-5d17-4c2b-bae4-cc581de72c13/threads/AAQkAGU3OGZjZTE2LTFlOWItNGExYi1hMGMzLTMwZWU4OGUzYjU5MQMkABAALmW2hn6Ui0_7hOBeAIFdWhAALmW2hn6Ui0_7hOBeAIFdWg==
Content-type: application/json
-Content-length: 419
{
- "@odata.type":"#Microsoft.OutlookServices.ConversationThread",
"isLocked": true } ```
Content-length: 419
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.conversationThread"
+ "truncated": true
} --> ```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 419
-{
- "toRecipients": [
- {
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
- }
- ],
- "topic": "topic-value",
- "hasAttachments": true,
- "lastDeliveredDateTime": "2016-10-19T10:37:00Z",
- "uniqueSenders": [
- "uniqueSenders-value"
- ],
- "ccRecipients": [
- {
- "emailAddress": {
- "name": "name-value",
- "address": "address-value"
- }
- }
- ],
- "isLocked": true
-}
+{}
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | AuditLog.Read.All |
+|Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported |
-|Application | AuditLog.Read.All |
+|Application | AuditLog.Read.All and Directory.Read.All |
In addition, apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-list.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | AuditLog.Read.All |
+|Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All |
|Delegated (personal Microsoft account) | Not supported |
-|Application | AuditLog.Read.All |
+|Application | AuditLog.Read.All and Directory.Read.All |
In addition, apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/domain-list-domainnamereferences.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /domains/{id}/domainNameReferences
+GET /domains/{domain-id}/domainNameReferences
```
-> For {id}, specify the domain with its fully qualified domain name.
- ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
GET https://graph.microsoft.com/beta/domains/contoso.com/domainNameReferences
##### Response
-Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
HTTP/1.1 200 OK
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
"value": [ {
- "odata.type": "Microsoft.DirectoryServices.User",
- "objectType": "User",
- "objectId": "567a0db6-289c-43f7-a650-2645c03cbbbb",
- "accountEnabled": true,
- "displayName": "TestUser1",
- "facsimileTelephoneNumber": null,
- "mailNickname": "testuser1",
- "mobile": null,
- "userPrincipalName": "testuser1@contoso.com"
+ "@odata.type": "#microsoft.graph.user",
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/fc9a2c2b-1ddc-486d-a211-5fe8ca77fa1f/Microsoft.DirectoryServices.User",
+ "id": "fc9a2c2b-1ddc-486d-a211-5fe8ca77fa1f",
+ "accountEnabled": true,
+ "city": "Nairobi",
+ "createdDateTime": "2021-04-14T05:26:16Z",
+ "country": "Kenya",
+ "displayName": "Adele Vance",
+ "givenName": "Adele",
+ "mail": "AdeleV@Contoso.com",
+ "mailNickname": "AdeleV"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/eac82bd3-931c-4d47-9e68-735595a8eb8a/Microsoft.DirectoryServices.Group",
+ "id": "eac82bd3-931c-4d47-9e68-735595a8eb8a",
+ "createdDateTime": "2021-04-14T06:59:47Z",
+ "createdByAppId": "00000005-0000-0ff1-ce00-000000000000",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "description": "Contribute your ideas and ask your questions to our leadership team. And tune in for regular Employee Q & A live events. You can learn more about what",
+ "displayName": "CEO Connection",
+ "expirationDateTime": "2021-10-11T06:59:47Z",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "ceoconnection@Contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "ceoconnection",
+ "resourceBehaviorOptions": [
+ "CalendarMemberReadOnly"
+ ],
+ "visibility": "Public",
+ "writebackConfiguration": {
+ "isEnabled": null,
+ "onPremisesGroupType": null
+ }
} ] }
v1.0 Identityproviderbase Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-get.md
GET https://graph.microsoft.com/beta/identity/identityProviders/Amazon-OAUTH
-- #### Response The following is an example of the response.
GET https://graph.microsoft.com/beta/identity/identityProviders/MSASignup-OAUTH
-- #### Response The following is an example of the response.
GET https://graph.microsoft.com/beta/identity/identityProviders/OIDC-V1-test-icm
-- #### Response The following is an example of the response.
GET https://graph.microsoft.com/beta/identity/identityProviders/Apple-Managed-OI
-- #### Response The following is an example of the response.
v1.0 Identityproviderbase List Availableprovidertypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-list-availableprovidertypes.md
If successful, this function returns a `200 OK` response code and a String colle
### Example 1: List all **identityProvider** available in an Azure AD directory
-### Request
+#### Request
The following is an example of the request. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/identity/identityProviders/availableProvide
--
-### Response
+#### Response
The following is an example of the response.
-**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
Content-Type: application/json
### Example 2: List all **identityProvider** available in an Azure AD B2C directory
-### Request
+#### Request
The following is an example of the request. # [HTTP](#tab/http)
GET https://graph.microsoft.com/beta/identity/identityProviders/availableProvide
--
-### Response
+#### Response
The following is an example of the response.
-**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 Identityproviderbase List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-list.md
If successful, this method returns a `200 OK` response code and a collection of
For an Azure AD B2C tenant this method returns a `200 OK` response code and a collection of [socialIdentityProvider](../resources/socialidentityprovider.md), [openIdConnectIdentityProvider](../resources/openidconnectidentityprovider.md) and/or [appleIdentityProvider](../resources/appleidentityprovider.md) objects in the response body.
-## Example
+## Examples
### Example 1: List all **identityProvider** configured in an Azure AD tenant
-### Request
+#### Request
The following is an example of the request.
GET https://graph.microsoft.com/beta/identity/identityProviders
-### Response
+#### Response
The following is an example of the response. **Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
### Example 2: List all **identityProvider** configured in an Azure AD B2C tenant
-### Request
+#### Request
The following is an example of the request. <!-- {
The following is an example of the request.
GET https://graph.microsoft.com/beta/identity/identityProviders ```
-### Response
+#### Response
The following is an example of the response. **Note:** The response object shown here might be shortened for readability.
v1.0 Identityproviderbase Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-post-identityproviders.md
All the properties listed in the following table are required.
|Property|Type|Description| |:|:--|:-| |clientId|String|The client identifier for the application obtained when registering the application with the identity provider.|
-|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns "\*\*\*\*".|
+|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns `****`.|
|displayName|String|The display name of the identity provider.| |identityProviderType|String|For a B2B scenario, possible values: `Google`, `Facebook`. For a B2C scenario, possible values: `Microsoft`, `Google`, `Amazon`, `LinkedIn`, `Facebook`, `GitHub`, `Twitter`, `Weibo`, `QQ`, `WeChat`.|
Content-length: 154
-- #### Response The following is an example of the response.
Content-type: application/json
- #### Response
v1.0 Identityproviderbase Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase-update.md
In Azure AD B2C, provide a JSON object with one or more properties that need to
|Property|Type|Description| |:|:--|:-| |clientId|String|The client identifier for the application obtained when registering the application with the identity provider.|
-|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns "\*\*\*\*".|
+|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns `****`.|
|displayName|String|The display name of the identity provider.| ### openIdConnectIdentityProvider object
The following is an example of the request.
``` http PATCH https://graph.microsoft.com/beta/identity/identityProviders/Amazon-OAUTH Content-type: application/json
-Content-length: 41
{
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
"clientSecret": "1111111111111" } ```
Content-length: 41
-- #### Response The following is an example of the response.
Content-length: 41
-- #### Response The following is an example of the response.
Content-length: 41
-- #### Response The following is an example of the response.
v1.0 Identityproviderbase https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/identityproviderbase.md
- Title: "identityProviderBase resource type"
-description: "Represents identity providers in an Azure Active Directory tenant and an Azure AD B2C tenant."
-localization_priority: Priority
-doc_type: resourcePageType
---
-# identityProviderBase resource type
-Namespace: microsoft.graph
--
-Represents identity providers with [External Identities](/azure/active-directory/external-identities/) for both Azure Active Directory tenant and an Azure AD B2C tenant.
-
-## Methods
-
-| Method | Return Type |Description|
-|:|:--|:-|
-|[List](../api/identityproviderbase-list.md)|identityProviderBase collection|Retrieve all identity providers configured in a tenant.|
-|[List available provider types](../api/identityproviderbase-list-availableprovidertypes.md)|String collection|Retrieve all available identity provider types.|
-
-## Properties
-
-|Property|Type|Description|
-|:|:--|:-|
-|id|String|The identifier of the identity provider.|
-|displayName|String|The display name of the identity provider.|
-
-## JSON representation
-
-The following is a JSON representation of the resource.
-
-<!-- {
- "blockType": "resource",
- "@odata.type": "microsoft.graph.identityProviderBase"
-} -->
-
-```json
-{
- "id": "String",
- "displayName": "String"
-}
-```
v1.0 Orgcontact List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/orgcontact-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/contacts?$filter=startswith(displayName,'A')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_phone_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/contacts?$search="displayName:wa"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Serviceprincipal List Ownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-ownedobjects.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+|Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
v1.0 Serviceprincipal List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/servicePrincipals?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_team_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/beta/servicePrincipals?$search="displayName:Team"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Signin Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-get.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-| Delegated (work or school account) | AuditLog.Read.All, Directory.Read.All |
+| Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All |
| Delegated (personal Microsoft account) | Not supported |
-| Application | AuditLog.Read.All, Directory.Read.All |
+| Application | AuditLog.Read.All and Directory.Read.All |
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Signin List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/signin-list.md
One of the following permissions is required to call this API. To learn more, in
| Permission type | Permissions (from least to most privileged) | |: |:- |
-| Delegated (work or school account) | AuditLog.Read.All, Directory.Read.All |
+| Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All |
| Delegated (personal Microsoft account) | Not supported |
-| Application | AuditLog.Read.All, Directory.Read.All |
+| Application | AuditLog.Read.All and Directory.Read.All |
Apps must be [properly registered](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to Azure AD.
v1.0 Termstore Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-group-get.md
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_group"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Termstore Set Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-set-get.md
If successful, this method returns a `200 OK` response code and a [set](../resou
#### Request
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_set_2"
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_siteCollection_termStore_set"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Termstore Store Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-store-get.md
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_store"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Termstore Term Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/termstore-term-get.md
Content-Type: application/json
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_term_1"
Content-Type: application/json
``` http GET https://graph.microsoft.com/beta/sites/microsoft.sharepoint.com,c6482504-4a85-4b21-858a-7e88dafc8232,d90ca07d-25c0-4ce7-864b-d68b607e697f/termStore/groups/1FFD3F87-9464-488A-A0EC-8FB90911182C/sets/8ed8c9ea-7052-4c1d-a4d7-b9c10bffea6f/terms/81be9856-9856-81be-5698-be815698be81 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response >**Note:** The response object shown here might be shortened for readability.
v1.0 Unifiedrolemanagementpolicyrule Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/unifiedrolemanagementpolicyrule-update.md
If successful, this method returns a `200 OK` response code and an updated [unif
``` http PATCH https://graph.microsoft.com/beta/policies/roleManagementPolicies/{unifiedRoleManagementPolicyId}/rules/{unifiedRoleManagementPolicyRuleId} Content-Type: application/json
-Content-length: 170
{
- "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyRule",
+ "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyApprovalRule",
"target": { "@odata.type": "microsoft.graph.unifiedRoleManagementPolicyRuleTarget" }
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-joinedteams.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
-> Currently, with user delegated permissions this operation only works for the 'me' user.
-> With application permissions, it works for all users by specifying the specific user id.
-> ('me' alias is not supported with application permissions)
-> For details, see [Known issues](/graph/known-issues#microsoft-teams-users-list-of-joined-teams-preview).
+> **Note:** Currently, with user delegated permissions, this operation only works for the `me` user. With application permissions, it works for all users by specifying the specific user ID (`me` alias is not supported with application permissions). For details, see [Known issues](/graph/known-issues#microsoft-teams-users-list-of-joined-teams-preview).
## HTTP request <!-- { "blockType": "ignored" } --> ```http GET /me/joinedTeams
-or
GET /users/{id | user-principal-name}/joinedTeams ``` ## Optional query parameters
-The [OData Query Parameters](/graph/query-parameters) are not currently supported.
+This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.
## Request headers | Header | Value |
Do not supply a request body for this method.
If successful, this method returns a `200 OK` response code and collection of [team](../resources/team.md) objects in the response body.
+> [!Note]
+> Currently, this API call returns only the **id**, **displayName**, and **description** properties of a [team](../resources/team.md). To get all properties, use the [Get team](../api/team-get.md) operation. For details, see [known issues](/graph/known-issues#unable-to-return-all-values-for-properties-for-a-user-joined-teams).
+ ## Example ### Request
-Here is an example of the request.
+The following example shows a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/beta/me/joinedTeams
### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-type: application/json
{ "value": [ {
- "id": "31aa74dd-dd65-43ac-8c4e-0ec1ae5a8ee1"
+ "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
+ "displayName": "Contoso Team",
+ "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
} ] } ``` ## See also
-[List all teams](/graph/teams-list-all-teams)
+- [List all teams](/graph/teams-list-all-teams)
+- [Get team](../api/team-get.md)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
v1.0 User Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-post-approleassignments.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | AppRoleAssignment.ReadWrite.All, Directory.AccessAsUser.All |
+|Delegated (work or school account) | User.Read.All and AppRoleAssignment.ReadWrite.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | AppRoleAssignment.ReadWrite.All |
+|Application | User.Read.All and AppRoleAssignment.ReadWrite.All |
## HTTP request
v1.0 Openidconnectidentityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/openidconnectidentityprovider.md
This type will inherit from [identityProviderBase](../resources/identityprovider
|Property|Type|Description| |:|:--|:-| |clientId|String|The client ID for the application obtained when registering the application with the identity provider. Required.|
-|clientSecret|String|The client secret for the application obtained when registering the application with the identity provider. The clientSecret has a dependency on **responseType**. <ul><li>When **responseType** is `code`, a secret is required for the auth code exchange.</li><li>When **responseType** is `id_token` the secret is not required because there is no code exchange. The id_token is returned directly from the authorization response.</li></ul> This is write-only. A read operation returns "\*\*\*\*".|
+|clientSecret|String|The client secret for the application obtained when registering the application with the identity provider. The clientSecret has a dependency on **responseType**. <ul><li>When **responseType** is `code`, a secret is required for the auth code exchange.</li><li>When **responseType** is `id_token` the secret is not required because there is no code exchange. The id_token is returned directly from the authorization response.</li></ul> This is write-only. A read operation returns `****`.|
|id|String|The identifier of the identity provider.Required. Inherited from [identityProviderBase](../resources/identityproviderbase.md). Read-only.| |displayName|String|The display name of the identity provider. | |claimsMapping|[claimsMapping](claimsmapping.md)|After the OIDC provider sends an ID token back to Azure AD, Azure AD needs to be able to map the claims from the received token to the claims that Azure AD recognizes and uses. This complex type captures that mapping. Required.|
v1.0 Policyroot https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/policyroot.md
Title: "policyRoot resource type"
-description: "A new navigation properties binding for unifiedRoleManagementPolicy and unifiedRoleManagementPolicyAssignment to policyRoot."
+description: "Resource type exposing navigation properties for the policies singleton."
localization_priority: Normal ms.prod: "governance"
doc_type: resourcePageType
Namespace: microsoft.graph
-A new navigation properties binding for unifiedRoleManagementPolicy and unifiedRoleManagementPolicyAssignment to policyRoot.
+Resource type exposing navigation properties for the policies singleton.
## Methods
-|Method|Return type|Description|
-|:|:|:|
-|[List roleManagementPolicies](../api/policyroot-list-rolemanagementpolicies.md)|[unifiedRoleManagementPolicy](../resources/unifiedrolemanagementpolicy.md) collection|Get the unifiedRoleManagementPolicy resources from the roleManagementPolicies navigation property.|
-|[List roleManagementPolicyAssignments](../api/policyroot-list-rolemanagementpolicyassignments.md)|[unifiedRoleManagementPolicyAssignment](../resources/unifiedrolemanagementpolicyassignment.md) collection|Get the unifiedRoleManagementPolicyAssignment resources from the roleManagementPolicyAssignments navigation property.|
+None
-<!--
## Properties
-|Property|Type|Description|
-|:|:|:|
+None
## Relationships
-|Relationship|Type|Description|
-|:|:|:|
-|roleManagementPolicies|[unifiedRoleManagementPolicy](../resources/unifiedrolemanagementpolicy.md) collection|Represents the role management policies.|
-|roleManagementPolicyAssignments|[unifiedRoleManagementPolicyAssignment](../resources/unifiedrolemanagementpolicyassignment.md) collection|Represents the role management policy assignments.|
>
+| Relationship | Type | Description |
+|:|:-|:|
+| authenticationMethodsPolicy | [authenticationMethodsPolicy](authenticationmethodspolicy.md) | The authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD). |
+| authenticationFlowsPolicy | [authenticationFlowsPolicy](authenticationflowspolicy.md) | The policy configuration of the self-service sign-up experience of external users. |
+| b2cAuthenticationMethodsPolicy | [b2cAuthenticationMethodsPolicy](b2cauthenticationmethodspolicy.md) | The Azure AD B2C policies that define how end users register via local accounts. |
+| activityBasedTimeoutPolicies | [activityBasedTimeoutPolicy](activitybasedtimeoutpolicy.md) collection | The policy that controls the idle time out for web sessions for applications. |
+| authorizationPolicy | [authorizationPolicy](authorizationpolicy.md) collection | The policy that controls Azure AD authorization settings. |
+| claimsMappingPolicies | [claimsMappingPolicy](claimsmappingpolicy.md) collection | The claim-mapping policies for WS-Fed, SAML, OAuth 2.0, and OpenID Connect protocols, for tokens issued to a specific application. |
+| homeRealmDiscoveryPolicies | [homeRealmDiscoveryPolicy](homerealmdiscoverypolicy.md) collection | The policy to control Azure AD authentication behavior for federated users. |
+| permissionGrantPolicies | [permissionGrantPolicy](permissiongrantpolicy.md) collection | The policy that specifies the conditions under which consent can be granted. |
+| tokenIssuancePolicies | [tokenIssuancePolicy](tokenissuancepolicy.md) collection | The policy that specifies the characteristics of SAML tokens issued by Azure AD. |
+| tokenLifetimePolicies | [tokenLifetimePolicy](tokenlifetimepolicy.md) collection | The policy that controls the lifetime of a JWT access token, an ID token, or a SAML 1.1/2.0 token issued by Azure AD. |
+| featureRolloutPolicies | [featureRolloutPolicy](featurerolloutpolicy.md) collection | The feature rollout policy associated with a directory object. |
+| accessReviewPolicy | [accessReviewPolicy](accessreviewpolicy.md) | The policy that contains directory-level access review settings. |
+| adminConsentRequestPolicy | [adminConsentRequestPolicy](adminconsentrequestpolicy.md) | The policy by which consent requests are created and managed for the entire tenant. |
+| conditionalAccessPolicies | [conditionalAccessPolicy](conditionalaccesspolicy.md) | The custom rules that define an access scenario. |
+| identitySecurityDefaultsEnforcementPolicy | [identitySecurityDefaultsEnforcementPolicy](identitysecuritydefaultsenforcementpolicy.md) | The policy that represents the security defaults that protect against common attacks. |
+| mobileAppManagementPolicies | [mobilityManagementPolicy](mobilitymanagementpolicy.md) collection | The policy that defines auto-enrollment configuration for a mobility management (MDM or MAM) application. |
+| roleManagementPolicies | [unifiedRoleManagementPolicy](../resources/unifiedrolemanagementpolicy.md) collection | Represents the role management policies. |
+| roleManagementPolicyAssignments | [unifiedRoleManagementPolicyAssignment](../resources/unifiedrolemanagementpolicyassignment.md) collection | Represents the role management policy assignments. |
+ ## JSON representation The following is a JSON representation of the resource.
v1.0 Socialidentityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/socialidentityprovider.md
Configuring an identity provider in your Azure AD B2C tenant enables users to si
|Property|Type|Description| |:|:--|:-| |clientId|String|The client identifier for the application obtained when registering the application with the identity provider. Required.|
-|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns "\*\*\*\*". Required.|
+|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns `****`. Required.|
|id|String|The identifier of the identity provider. Inherited from [identityProviderBase](../resources/identityproviderbase.md). Read-only.| |displayName|String|The display name of the identity provider. Inherited from [identityProviderBase](../resources/identityproviderbase.md).| |identityProviderType|String|For a B2B scenario, possible values: `Google`, `Facebook`. For a B2C scenario, possible values: `Microsoft`, `Google`, `Amazon`, `LinkedIn`, `Facebook`, `GitHub`, `Twitter`, `Weibo`, `QQ`, `WeChat`. Required.|
v1.0 Unifiedrolemanagementpolicyruletarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/unifiedrolemanagementpolicyruletarget.md
doc_type: resourcePageType
Namespace: microsoft.graph A unifiedRoleManagementPolicyRuleTarget specifies the target associated with the role management policy.
-<!--
++ ## Properties |Property|Type|Description| |:|:|:|
-|caller|String|The caller for the policy rule target. One of None, Admin, EndUser. |
-|enforcedSettings|String collection|The list of settings which are enforced and cannot be overridden by child scopes. Use All for all settings.|
-|inheritableSettings|String collection|The list of settings which can be inherited by child scopes. Use All for all settings.|
-|level|String|The level for the policy rule target. One of Eligibility, Assignment. |
-|operations|String collection|The operations for policy rule target. One of All, Activate, Deactivate, Assign, Update, Remove, Extend, Renew.|
+|caller|String|The caller for the policy rule target. Allowed values are: `None`, `Admin`, `EndUser`.|
+|enforcedSettings|String collection|The list of settings which are enforced and cannot be overridden by child scopes. Use `All` for all settings.|
+|inheritableSettings|String collection|The list of settings which can be inherited by child scopes. Use `All` for all settings.|
+|level|String|The level for the policy rule target. Allowed values are: `Eligibility`, `Assignment`. |
+|operations|String collection|The operations for policy rule target. Allowed values are: `All`, `Activate`, `Deactivate`, `Assign`, `Update`, `Remove`, `Extend`, `Renew`.|
## Relationships |Relationship|Type|Description|
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/applications?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_web_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/applications?$search="displayName:Web"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Application Post Calls https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-post-calls.md
Content-Type: application/json
"user": { "@odata.type": "#microsoft.graph.identity", "id": "5810cede-f3cc-42eb-b2c1-e9bd5d53ec96",
+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a",
"displayName": "Bob" } }, "allowConversationWithoutHost": true
- }
+ },
+ "tenantId": "aa67bd4c-8475-432d-bd41-39f255720e0a"
} ```
v1.0 Application Setverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-setverifiedpublisher.md
Content-type: application/json
[!INCLUDE [sample-code](../includes/snippets/javascript/application-setverifiedpublisher-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [C#](#tab/csharp)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+
v1.0 Application Unsetverifiedpublisher https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/application-unsetverifiedpublisher.md
POST https://graph.microsoft.com/v1.0/applications/{id}/unsetVerifiedPublisher
[!INCLUDE [sample-code](../includes/snippets/objc/application-unsetverifiedpublisher-objc-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+# [C#](#tab/csharp)
+
+# [Java](#tab/java)
+
v1.0 Authenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/authenticationmethodspolicy-get.md
+
+ Title: "Get authenticationMethodsPolicy"
+description: "Read the properties and relationships of an authenticationMethodsPolicy object."
+
+localization_priority: Normal
++
+# Get authenticationMethodsPolicy
+Namespace: microsoft.graph
+
+Read the properties and relationships of an [authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /policies/authenticationMethodsPolicy
+```
+
+## Optional query parameters
+This method does not support any optional query parameters.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md) object in the response body.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "get_authenticationmethodspolicy"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy
+```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.authenticationMethodsPolicy"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#authenticationMethodsPolicy",
+ "id": "authenticationMethodsPolicy",
+ "displayName": "Authentication Methods Policy",
+ "description": "The tenant-wide policy that controls which authentication methods are allowed in the tenant, authentication method registration requirements, and self-service password reset settings",
+ "lastModifiedDateTime": "2021-07-02T13:34:13.1991781Z",
+ "policyVersion": "1.4",
+ "authenticationMethodConfigurations@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations",
+ "authenticationMethodConfigurations": [
+ {
+ "@odata.type": "#microsoft.graph.fido2AuthenticationMethodConfiguration",
+ "id": "Fido2",
+ "state": "enabled",
+ "isSelfServiceRegistrationAllowed": true,
+ "isAttestationEnforced": true,
+ "keyRestrictions": {
+ "isEnforced": false,
+ "enforcementType": "block",
+ "aaGuids": []
+ },
+ "includeTargets@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Fido2')/microsoft.graph.fido2AuthenticationMethodConfiguration/includeTargets",
+ "includeTargets": [
+ {
+ "targetType": "group",
+ "id": "all_users",
+ "isRegistrationRequired": false
+ }
+ ]
+ },
+ {
+ "@odata.type": "#microsoft.graph.microsoftAuthenticatorAuthenticationMethodConfiguration",
+ "id": "MicrosoftAuthenticator",
+ "state": "disabled",
+ "includeTargets@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('MicrosoftAuthenticator')/microsoft.graph.microsoftAuthenticatorAuthenticationMethodConfiguration/includeTargets",
+ "includeTargets": [
+ {
+ "targetType": "group",
+ "id": "all_users",
+ "isRegistrationRequired": false,
+ "authenticationMode": "any",
+ "featureSettings": null
+ }
+ ]
+ },
+ {
+ "@odata.type": "#microsoft.graph.emailAuthenticationMethodConfiguration",
+ "id": "Email",
+ "state": "enabled",
+ "allowExternalIdToUseEmailOtp": "default",
+ "includeTargets@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/authenticationMethodsPolicy/authenticationMethodConfigurations('Email')/microsoft.graph.emailAuthenticationMethodConfiguration/includeTargets",
+ "includeTargets": []
+ }
+ ]
+}
+```
v1.0 Authenticationmethodspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/authenticationmethodspolicy-update.md
+
+ Title: "Update authenticationMethodsPolicy"
+description: "Update the properties of an authenticationMethodsPolicy object."
+
+localization_priority: Normal
++
+# Update authenticationMethodsPolicy
+Namespace: microsoft.graph
+
+Update the properties of an [authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Policy.ReadWrite.AuthenticationMethod|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Policy.ReadWrite.AuthenticationMethod|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /policies/authenticationMethodsPolicy
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the [authenticationMethodConfigurations](../resources/authenticationmethodconfiguration.md) object to prompt users to set up targeted authentication methods.
+
+## Response
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
++
+# [HTTP](#tab/http)
+<!-- {
+ "blockType": "request",
+ "name": "update_authenticationmethodspolicy"
+}
+-->
+``` http
+PATCH https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#authenticationMethodsPolicy",
+ "authenticationMethodConfigurations": [
+ {
+ "@odata.type": "#microsoft.graph.fido2AuthenticationMethodConfiguration",
+ "id": "Fido2",
+ "state": "disabled",
+ "isSelfServiceRegistrationAllowed": false,
+ "isAttestationEnforced": false,
+ "keyRestrictions": {
+ "isEnforced": false,
+ "enforcementType": "block",
+ "aaGuids": []
+ }
+ }
+ ]
+}
+```
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++++
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+
+```
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/channel-list-messages.md
The following is an example of the request.
"blockType": "request", "name": "get_listchannelmessages_1" }-->
-```http
+```msgraph-interactive
GET https://graph.microsoft.com/v1.0/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages ``` # [C#](#tab/csharp)
v1.0 Chatmessage Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-post.md
The following is an example of the request. For information about how to get a l
> Note: **conversationIdentityType** must be set to `channel` to @mention a channel. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_chatmessage_atmentionchannel"
Content-type: application/json
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
The following is an example of the request.
> Note: **conversationIdentityType** must be set to `team` to @mention a team. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "post_chatmessage_atmentionteam"
Content-type: application/json
"reactions": [] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Conversationthread List Posts https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversationthread-list-posts.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /groups/{id}/threads/{id}/posts
-GET /groups/{id}/conversations/{id}/threads/{id}/posts
+GET /groups/{groupId}/threads/{threadId}/posts
+GET /groups/{groupId}/conversations/{conversationId}/threads/{threadId}/posts
``` ## Optional query parameters
Here is an example of the request.
"name": "get_posts" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/groups/{id}/threads/{id}/posts
+GET https://graph.microsoft.com/v1.0/groups/02f3bafb-448c-487c-88c2-5fd65ce49a41/threads/AAQkADI5YzgxODgyLTExZDgtNDhkMS1iZDRjLTBhZGZiN2ExYWQxNwMkABAADW7fw6FZNEuyjrGA9R8SshAADW7fw6FZNEuyjrGA9R8Ssg==/posts
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-posts-csharp-snippets.md)]
Here is an example of the response. Note: The response object shown here might b
```http HTTP/1.1 200 OK Content-type: application/json
-Content-length: 523
{
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups('02f3bafb-448c-487c-88c2-5fd65ce49a41')/threads('AAQkADI5YzgxODgyLTExZDgtNDhkMS1iZDRjLTBhZGZiN2ExYWQxNwMkABAADW7fw6FZNEuyjrGA9R8SshAADW7fw6FZNEuyjrGA9R8Ssg%3D%3D')/posts",
"value": [ {
+ "@odata.etag": "W/\"CQAAABYAAACWM1XFF4buR6Xp/9aBq6+wAAAAAAEK\"",
+ "id": "AAMkADI5YzgxODgyLTExZDgtNDhkMS1iZDRjLTBhZGZiN2ExYWQxNwBGAAAAAAAmtAlgzc6xQZmiHzuqNLQ8BwCWM1XFF4buR6Xp-9aBq6_wAAAAAAEMAACWM1XFF4buR6Xp-9aBq6_wAAAAAAk9AAA=",
+ "createdDateTime": "2021-04-14T07:01:07Z",
+ "lastModifiedDateTime": "2021-04-14T07:01:08Z",
+ "changeKey": "CQAAABYAAACWM1XFF4buR6Xp/9aBq6+wAAAAAAEK",
+ "categories": [],
+ "receivedDateTime": "2021-04-14T07:01:07Z",
+ "hasAttachments": false,
"body": {
- "contentType": "",
- "content": "content-value"
+ "contentType": "html",
+ "content": "<html><body><div><div style=\"direction:ltr;\"><table border=\"0\" cellspacing=\"0\" cellpadding=\"0\" id=\"x_bodyTable\" style=\"vertical-align:top;width:100%;height:100%;border-spacing:0;border-collapse:collapse;margin:0;padding:0;border-width:0;box-sizing:border-box;\"><tr style=\"vertical-align:top;margin:0;padding:0;border-width:0;box-sizing:border-box;\"><td id=\"x_bodyCell\" style=\"vertical-align:top;direction:ltr;width:100%;height:100%;margin:0;padding:0;border-width:0;box-sizing:border-box;\"><table border=\"0\" cellspacing=\"0\" cellpadding=\"0\" id=\"x_content\" style=\"font-family:Segoe UI,Tahoma,Microsoft Sans Serif,Verdana,sans-serif;vertical-align:top;border-spacing:0;border-collapse:collapse;margin:0;padding:0;border-width:0;box-sizing:border-box;\"><tr style=\"vertical-align:top;margin:0;padding:0;border-width:0;box-sizing:border-box;\"><td style=\"font-family:Segoe UI,Tahoma,Microsoft Sans Serif,Verdana,sans-serif;vertical-align:top;height:64px;margin:0;padding:0 0 20px 0;border-width:0;box-sizing:border-box;\"><div style=\"color:#0072C6;font-size:18pt;vertical-align:top;margin:0;padding:0;border-width:0;box-sizing:border-box;\">Welcome to the Contoso Life group...."
},
- "receivedDateTime": "datetime-value",
- "hasAttachments": true,
"from": { "emailAddress": {
- "name": "name-value",
- "address": "address-value"
+ "name": "Contoso Life",
+ "address": "contosolife@M365x435773.onmicrosoft.com"
} }, "sender": { "emailAddress": {
- "name": "name-value",
- "address": "address-value"
+ "name": "Contoso Life",
+ "address": "contosolife@M365x435773.onmicrosoft.com"
}
- },
- "conversationThreadId": "conversationThreadId-value"
+ }
} ] }
v1.0 Conversationthread Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/conversationthread-update.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /groups/{id}/threads/{id}
-PATCH /groups/{id}/conversations/{id}/threads/{id}
+PATCH /groups/{group id}/threads/{thread id}
+PATCH /groups/{group id}/conversations/{conversation id}/threads/{thread id}
``` ## Request headers
In the request body, supply the values for relevant fields that should be update
## Response
-If successful, this method returns a `200 OK` response code and updated [conversationThread](../resources/conversationthread.md) object in the response body.
+If successful, this method returns a `200 OK` response code and an empty object in the response body.
## Example
-##### Request
+### Request
Here is an example of the request. # [HTTP](#tab/http) <!-- {
- "blockType": "request",
+ "blockType": "ignored",
"name": "update_conversationthread" }--> ```http
-PATCH https://graph.microsoft.com/v1.0/groups/{id}/threads/{id}
+PATCH https://graph.microsoft.com/v1.0/groups/0fbf2921-5d17-4c2b-bae4-cc581de72c13/threads/AAQkAGU3OGZjZTE2LTFlOWItNGExYi1hMGMzLTMwZWU4OGUzYjU5MQMkABAALmW2hn6Ui0_7hOBeAIFdWhAALmW2hn6Ui0_7hOBeAIFdWg==
Content-type: application/json
-Content-length: 419
{
- "@odata.type":"#Microsoft.OutlookServices.ConversationThread",
"isLocked": true } ```
Content-length: 419
-##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+### Response
+The following is an example of the response.
<!-- { "blockType": "response",
- "truncated": true,
- "@odata.type": "microsoft.graph.conversationThread"
+ "truncated": true
} --> ```http HTTP/1.1 200 OK 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"
- }
- }
- ],
- "isLocked": true
-}
+{}
``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Device List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/device-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/devices?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_android_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/devices?$search="displayName:Android"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Directoryaudit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryaudit-get.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All | |Delegated (personal Microsoft account) | Not supported |
-|Application | AuditLog.Read.All |
+|Application | AuditLog.Read.All and Directory.Read.All |
## HTTP request
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryaudit-list.md
One of the following permissions is required to call this API. To learn more, in
| :- | : | | Delegated (work or school account) | AuditLog.Read.All and Directory.Read.All | | Delegated (personal Microsoft account) | Not supported |
-| Application | AuditLog.Read.All |
+| Application | AuditLog.Read.All and Directory.Read.All |
## HTTP request
v1.0 Domain List Domainnamereferences https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/domain-list-domainnamereferences.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /domains/{id}/domainNameReferences
+GET /domains/{domain-id}/domainNameReferences
```
-> For {id}, specify the domain with its fully qualified domain name.
- ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
If successful, this method returns a `200 OK` response code and collection of [d
"name": "get_domainnamereferences" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/domains/{domain-name}/domainNameReferences
+GET https://graph.microsoft.com/v1.0/domains/contoso.com/domainNameReferences
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-domainnamereferences-csharp-snippets.md)]
GET https://graph.microsoft.com/v1.0/domains/{domain-name}/domainNameReferences
##### Response
-Note: The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
HTTP/1.1 200 OK
Content-type: application/json {
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#directoryObjects",
"value": [ {
- "odata.type": "Microsoft.DirectoryServices.User",
- "objectType": "User",
- "objectId": "567a0db6-289c-43f7-a650-2645c03cbbbb",
- "accountEnabled": true,
- "displayName": "TestUser1",
- "facsimileTelephoneNumber": null,
- "mailNickname": "testuser1",
- "mobile": null,
- "userPrincipalName": "testuser1@contoso.com"
+ "@odata.type": "#microsoft.graph.user",
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/fc9a2c2b-1ddc-486d-a211-5fe8ca77fa1f/Microsoft.DirectoryServices.User",
+ "id": "fc9a2c2b-1ddc-486d-a211-5fe8ca77fa1f",
+ "accountEnabled": true,
+ "city": "Nairobi",
+ "createdDateTime": "2021-04-14T05:26:16Z",
+ "country": "Kenya",
+ "displayName": "Adele Vance",
+ "givenName": "Adele",
+ "mail": "AdeleV@Contoso.com",
+ "mailNickname": "AdeleV"
+ },
+ {
+ "@odata.type": "#microsoft.graph.group",
+ "@odata.id": "https://graph.microsoft.com/v2/927c6607-8060-4f4a-a5f8-34964ac78d70/directoryObjects/eac82bd3-931c-4d47-9e68-735595a8eb8a/Microsoft.DirectoryServices.Group",
+ "id": "eac82bd3-931c-4d47-9e68-735595a8eb8a",
+ "createdDateTime": "2021-04-14T06:59:47Z",
+ "createdByAppId": "00000005-0000-0ff1-ce00-000000000000",
+ "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
+ "description": "Contribute your ideas and ask your questions to our leadership team. And tune in for regular Employee Q & A live events. You can learn more about what",
+ "displayName": "CEO Connection",
+ "expirationDateTime": "2021-10-11T06:59:47Z",
+ "groupTypes": [
+ "Unified"
+ ],
+ "mail": "ceoconnection@Contoso.com",
+ "mailEnabled": true,
+ "mailNickname": "ceoconnection",
+ "resourceBehaviorOptions": [
+ "CalendarMemberReadOnly"
+ ],
+ "visibility": "Public",
+ "writebackConfiguration": {
+ "isEnabled": null,
+ "onPremisesGroupType": null
+ }
} ] }
v1.0 Externalconnectors Connectionoperation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-connectionoperation-get.md
If successful, this method returns a `200 OK` response code and a [connectionOpe
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_connectionoperation"
If successful, this method returns a `200 OK` response code and a [connectionOpe
``` http GET https://graph.microsoft.com/v1.0/connections/contosohr/operations/3ed1595a-4bae-43c2-acda-ef973e581323 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors External Post Connections https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-external-post-connections.md
If successful, this method returns a `201 Created` response code and an [externa
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_externalconnection_from_connections"
Content-Type: application/json
"description": "Connection to index Contoso HR system" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors Externalconnection Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalconnection-delete.md
If successful, this method returns `202 Accepted` response code. It does not ret
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_externalconnection"
If successful, this method returns `202 Accepted` response code. It does not ret
``` http DELETE https://graph.microsoft.com/v1.0/connections/contosohr ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors Externalconnection Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalconnection-get.md
If successful, this method returns a `200 OK` response code and an [externalConn
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_externalconnection"
If successful, this method returns a `200 OK` response code and an [externalConn
``` http GET https://graph.microsoft.com/v1.0/connections/contosohr ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors Externalconnection List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalconnection-list.md
If successful, this method returns a `200 OK` response code and a collection of
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list_externalconnection"
If successful, this method returns a `200 OK` response code and a collection of
``` http GET https://graph.microsoft.com/v1.0/connections ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors Externalconnection Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalconnection-update.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_externalconnection"
Content-type: application/json
"description": "Connection to index HR service tickets" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ <!-- markdownlint-disable MD024 --> ### Response
The following is an example of the response.
```http HTTP/1.1 204 No Content
-```
+```
v1.0 Externalconnectors Externalitem Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalitem-create.md
If successful, this method returns `200 OK` response code.
### Example: Create a custom item ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_externalitem_from_externalConnections"
Content-type: application/json
} } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+++ ### Response
v1.0 Externalconnectors Externalitem Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalitem-delete.md
If successful, this method returns a `204 No Content` response code.
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_externalitem"
If successful, this method returns a `204 No Content` response code.
``` http DELETE https://graph.microsoft.com/v1.0/connections/contosohr/items/TSP228082938 ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Externalconnectors Externalitem Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-externalitem-update.md
If successful, this method returns a `200 OK` response code and an updated [exte
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_externalitem",
Content-length: 360
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-type: application/json
"suppressions": [ "Error: update_externalitem/properties:\r\n Referenced type microsoft.graph.object is not defined in the doc set! Potential suggestion: microsoft.graph.directoryObject" ]
-}-->
+}-->
v1.0 Externalconnectors Schema Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-schema-create.md
Prefer: respond-async
] } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Externalconnectors Schema Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/externalconnectors-schema-get.md
If successful, this method returns a `200 OK` response code and a [schema](../re
## Examples ### Request+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_schema"
If successful, this method returns a `200 OK` response code and a [schema](../re
``` http GET https://graph.microsoft.com/v1.0/connections/contosohr/schema ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/group-list.md
The following is an example of the request. This request requires the **Consiste
#### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_groups_withlicenseerrors_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/groups?$count=true&$filter=hasMembersWithLicenseErrors+eq+true&$select=id,displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/groups?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Identityprovider Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityprovider-delete.md
The following example deletes an **identityProvider**.
##### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete-identityprovider"
The following example deletes an **identityProvider**.
```http DELETE https://graph.microsoft.com/v1.0/identityProviders/Amazon-OAuth ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ##### Response
v1.0 Identityprovider Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityprovider-get.md
The following example retrieves a specific **identityProvider**.
##### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get-identityprovider"
The following example retrieves a specific **identityProvider**.
```msgraph-interactive GET https://graph.microsoft.com/v1.0/identityProviders/Amazon-OAuth ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ##### Response
v1.0 Identityprovider List Availableprovidertypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityprovider-list-availableprovidertypes.md
If successful, this function returns a `200 OK` response code and a String colle
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "identityprovider_availableprovidertypes"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identityProviders/availableProviderTypes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Identityprovider List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityprovider-list.md
The following example retrieves all **identityProvider**.
##### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "list-identityproviders"
The following example retrieves all **identityProvider**.
```msgraph-interactive GET https://graph.microsoft.com/v1.0/identityProviders ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ##### Response
v1.0 Identityprovider Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityprovider-update.md
The following example updates the definition of the token lifetime **identityPro
##### Request +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update-identityprovider"
Content-length: 41
"clientSecret": "1111111111111" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ##### Response
v1.0 Identityproviderbase Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-delete.md
The following is an example of the request.
+
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "delete_identityprovider"
The following is an example of the request.
``` http DELETE https://graph.microsoft.com/v1.0/identity/identityProviders/{id} ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response <!-- {
v1.0 Identityproviderbase Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-get.md
For an Azure AD B2C tenant, this method returns a `200 OK` response code and a J
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_socialidentityprovider_from_identityproviderbase"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identity/identityProviders/Amazon-OAUTH ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_builtinidentityprovider_from_identityproviderbase"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identity/identityProviders/MSASignup-OAUTH ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Identityproviderbase List Availableprovidertypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-list-availableprovidertypes.md
If successful, this function returns a `200 OK` response code and a String colle
### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "identityprovider_availableprovidertypes"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identity/identityProviders/availableProviderTypes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
Content-Type: application/json
### Request The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "identityprovider_availableprovidertypes_b2c"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identity/identityProviders/availableProviderTypes ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ ### Response
v1.0 Identityproviderbase List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-list.md
If successful, this method returns a `200 OK` response code and a collection of
For an Azure AD B2C tenant this method returns a `200 OK` response code and a collection of [socialIdentityProvider](../resources/socialidentityprovider.md) objects in the response body.
-## Example
+## Examples
### Example 1: List all identity providers configured in an Azure AD tenant
-### Request
+#### Request
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_identityproviderbase"
The following is an example of the request.
``` http GET https://graph.microsoft.com/v1.0/identity/identityProviders ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++
-### Response
+#### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
Content-Type: application/json
### Example 2: List all identityProvider objects configured in an Azure AD B2C tenant
-### Request
+#### Request
The following is an example of the request. <!-- {
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/identity/identityProviders ```
-### Response
+#### Response
The following is an example of the response. >**Note:** The response object shown here might be shortened for readability.
v1.0 Identityproviderbase Post Identityproviders https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-post-identityproviders.md
If unsuccessful, a `4xx` error will be returned with specific details.
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "create_socialidentityprovider_from_identityproviderbase"
Content-type: application/json
"clientSecret": "000000000000" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Identityproviderbase Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/identityproviderbase-update.md
In Azure AD B2C, provide the OData type and the JSON object with one or more pro
|Property|Type|Description| |:|:--|:-| |clientId|String|The identifier for the client application obtained when registering the application with the identity provider.|
-|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns "\*\*\*\*".|
+|clientSecret|String|The client secret for the application that is obtained when the application is registered with the identity provider. This is write-only. A read operation returns `****`.|
|displayName|String|The display name of the identity provider.| ## Response
If successful, this method returns a `204 No Content` response code. If unsucces
The following is an example of the request. +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "update_socialidentityprovider"
PATCH https://graph.microsoft.com/v1.0/identity/identityProviders/Amazon-OAUTH
Content-type: application/json {
- "@odata.type": "microsoft.graph.socialIdentityProvider",
+ "@odata.type": "#microsoft.graph.socialIdentityProvider",
"clientSecret": "1111111111111" } ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
```http HTTP/1.1 204 No Content
-```
+```
v1.0 Orgcontact List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/orgcontact-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/contacts?$filter=startswith(displayName,'A')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_phone_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/contacts?$search="displayName:wa"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 Serviceprincipal List Ownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-list-ownedobjects.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
+|Application | Application.Read.All, Application.ReadWrite.OwnedBy, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
[!INCLUDE [limited-info](../../includes/limited-info.md)]
v1.0 Serviceprincipal List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-list.md
Content-type: text/plain
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` and the `$count=true` query string because the request has both the `$orderBy` and `$filter` query parameters. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_a_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/servicePrincipals?$filter=startswith(displayName, 'a')&$count=true&$top=1&$orderby=displayName ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
Content-type: application/json
The following is an example of the request. This request requires the **ConsistencyLevel** header set to `eventual` because `$search` and the `$count=true` query string is in the request. For more information about the use of **ConsistencyLevel** and `$count`, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). +
+# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "get_team_count"
The following is an example of the request. This request requires the **Consiste
GET https://graph.microsoft.com/v1.0/servicePrincipals?$search="displayName:Team"&$count=true ConsistencyLevel: eventual ```
+# [C#](#tab/csharp)
+
+# [JavaScript](#tab/javascript)
+
+# [Objective-C](#tab/objc)
+
+# [Java](#tab/java)
+++ #### Response
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-joinedteams.md
One of the following permissions is required to call this API. To learn more, in
|Delegated (personal Microsoft account) | Not supported. | |Application | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
-> With user delegated permissions this operation only works for the 'me' user.
-> With application permissions, it works for all users by specifying the specific user id.
-> ('me' alias is not supported with application permissions)
+> **Note:** Currently, with user delegated permissions, this operation only works for the `me` user. With application permissions, it works for all users by specifying the specific user ID (`me` alias is not supported with application permissions). For details, see [Known issues](/graph/known-issues#microsoft-teams-users-list-of-joined-teams-preview).
## HTTP request <!-- { "blockType": "ignored" } --> ```http GET /me/joinedTeams
-or
GET /users/{id | user-principal-name}/joinedTeams ``` ## Optional query parameters
-The [OData Query Parameters](/graph/query-parameters) are not currently supported.
+This method does not currently support the [OData query parameters](/graph/query-parameters) to customize the response.
## Request headers | Header | Value |
Do not supply a request body for this method.
## Response
-If successful, this method returns a `200 OK` response code and collection of [group](../resources/group.md) objects in the response body.
+If successful, this method returns a `200 OK` response code and collection of [team](../resources/team.md) objects in the response body.
+
+> [!Note]
+> Currently, this API call returns only the **id**, **displayName**, and **description** properties of a [team](../resources/team.md). To get all properties, use the [Get team](../api/team-get.md) operation. For details, see [known issues](/graph/known-issues#unable-to-return-all-values-for-properties-for-a-user-joined-teams).
+ ## Example ##### Request
-Here is an example of the request.
+The following example shows a request.
# [HTTP](#tab/http) <!-- {
GET https://graph.microsoft.com/v1.0/me/joinedTeams
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-type: application/json
{ "value": [ {
- "id": "31aa74dd-dd65-43ac-8c4e-0ec1ae5a8ee1"
+ "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
+ "displayName": "Contoso Team",
+ "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
} ] } ``` ## See also
-[List all teams](/graph/teams-list-all-teams)
+- [List all teams](/graph/teams-list-all-teams)
+- [Get team](../api/team-get.md)
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC -->
-<!-- {
+<!--
+{
"type": "#page.annotation", "description": "List joinedTeams", "keywords": "",
Content-type: application/json
"tocPath": "", "suppressions": [ ]
-}-->
+}
+-->
v1.0 User Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-post-approleassignments.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | AppRoleAssignment.ReadWrite.All, Directory.AccessAsUser.All |
+|Delegated (work or school account) | User.Read.All and AppRoleAssignment.ReadWrite.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. |
-|Application | AppRoleAssignment.ReadWrite.All |
+|Application | User.Read.All and AppRoleAssignment.ReadWrite.All |
## HTTP request
v1.0 Accessreviewscheduledefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/accessreviewscheduledefinition.md
Inherits from [entity](../resources/entity.md).
|[Delete accessReviewScheduleDefinition](../api/accessreviewscheduledefinition-delete.md) | None. | Delete an accessReviewScheduleDefinition with a specified **id**. | |[Update accessReviewScheduleDefinition](../api/accessreviewscheduledefinition-update.md) | None. | Update properties of an accessReviewScheduleDefinition with a specified **id**. | |[filterByCurrentUser](../api/accessreviewscheduledefinition-filterbycurrentuser.md)|[accessReviewScheduleDefinition](../resources/accessreviewscheduledefinition.md) collection|Retrieves all definitions for which the calling user is a reviewer on one or more instance.|
-|[List instances](../api/accessreviewscheduledefinition-list-instances.md)|[accessReviewInstance](../resources/accessreviewinstance.md) collection|Get the accessReviewInstance resources from the instances navigation property.|
## Properties |Property|Type|Description|
v1.0 Authenticationmethodspolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/authenticationmethodspolicy.md
+
+ Title: "authenticationMethodsPolicy resource type"
+description: "Defines authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA)."
+
+localization_priority: Normal
++
+# authenticationMethodsPolicy resource type
+
+Namespace: microsoft.graph
+
+Defines authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[Get authenticationMethodsPolicy](../api/authenticationmethodspolicy-get.md)|[authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md)|Read the properties and relationships of an [authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md) object.|
+|[Update authenticationMethodsPolicy](../api/authenticationmethodspolicy-update.md)|[authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md)|Update the properties of an [authenticationMethodsPolicy](../resources/authenticationmethodspolicy.md) object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|description|String|A description of the policy. Read-only.|
+|displayName|String|The name of the policy. Read-only.|
+|id|String|The identifier of the policy. Inherited from [entity](../resources/entity.md).|
+|lastModifiedDateTime|DateTimeOffset|The date and time of the last update to the policy. Read-only.|
+|policyVersion|String|The version of the policy in use. Read-only.|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|authenticationMethodConfigurations|[authenticationMethodConfiguration](../resources/authenticationmethodconfiguration.md) collection|Represents the settings for each authentication method.|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.authenticationMethodsPolicy",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.authenticationMethodsPolicy",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "description": "String",
+ "lastModifiedDateTime": "String (timestamp)",
+ "policyVersion": "String",
+}
+```
v1.0 Policyroot https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/policyroot.md
+
+ Title: "policyRoot resource type"
+description: "Resource type exposing navigation properties for the policies singleton."
+
+localization_priority: Normal
++
+# policyRoot resource type
+
+Namespace: microsoft.graph
+
+Resource type exposing navigation properties for the policies singleton.
+
+## Methods
+None
+
+## Properties
+None
++
+## Relationships
+| Relationship | Type | Description |
+|:|:-|:|
+| authenticationMethodsPolicy | [authenticationMethodsPolicy](authenticationmethodspolicy.md) | The authentication methods and the users that are allowed to use them to sign in and perform multi-factor authentication (MFA) in Azure Active Directory (Azure AD). |
+| authenticationFlowsPolicy | [authenticationFlowsPolicy](authenticationflowspolicy.md) | The policy configuration of the self-service sign-up experience of external users. |
+| activityBasedTimeoutPolicies | [activityBasedTimeoutPolicy](activitybasedtimeoutpolicy.md) collection | The policy that controls the idle time out for web sessions for applications. |
+| authorizationPolicy | [authorizationPolicy](authorizationpolicy.md) collection | The policy that controls Azure AD authorization settings. |
+| claimsMappingPolicies | [claimsMappingPolicy](claimsmappingpolicy.md) collection | The claim-mapping policies for WS-Fed, SAML, OAuth 2.0, and OpenID Connect protocols, for tokens issued to a specific application. |
+| homeRealmDiscoveryPolicies | [homeRealmDiscoveryPolicy](homerealmdiscoverypolicy.md) collection | The policy to control Azure AD authentication behavior for federated users. |
+| permissionGrantPolicies | [permissionGrantPolicy](permissiongrantpolicy.md) collection | The policy that specifies the conditions under which consent can be granted. |
+| tokenIssuancePolicies | [tokenIssuancePolicy](tokenissuancepolicy.md) collection | The policy that specifies the characteristics of SAML tokens issued by Azure AD. |
+| tokenLifetimePolicies | [tokenLifetimePolicy](tokenlifetimepolicy.md) collection | The policy that controls the lifetime of a JWT access token, an ID token, or a SAML 1.1/2.0 token issued by Azure AD. |
+| featureRolloutPolicies | [featureRolloutPolicy](featurerolloutpolicy.md) collection | The feature rollout policy associated with a directory object. |
+| adminConsentRequestPolicy | [adminConsentRequestPolicy](adminconsentrequestpolicy.md) | The policy by which consent requests are created and managed for the entire tenant. |
+| conditionalAccessPolicies | [conditionalAccessPolicy](conditionalaccesspolicy.md) | The custom rules that define an access scenario. |
+| identitySecurityDefaultsEnforcementPolicy | [identitySecurityDefaultsEnforcementPolicy](identitysecuritydefaultsenforcementpolicy.md) | The policy that represents the security defaults that protect against common attacks. |
++
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.policyRoot",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.policyRoot"
+}
+```
+
v1.0 Preauthorizedapplication https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/preauthorizedapplication.md
Lists the client applications that are pre-authorized with the specified permiss
| Property | Type | Description | |:|:--|:-| |appId|String| The unique identifier for the application. |
-|delegatedPermissionIds|String collection| The unique identifier for the [oauth2PermissionScopes](permissionscope.md) the application requires. |
+|permissionIds|String collection| The unique identifier for the [oauth2PermissionScopes](permissionscope.md) the application requires. |
## JSON representation Here is a JSON representation of the resource.
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/windowshelloforbusinessauthenticationmethod-get.md - name: Delete href: api/windowshelloforbusinessauthenticationmethod-delete.md
- - name: Authentication method policy
+ - name: Authentication methods policy
items: - name: Overview href: resources/authenticationmethodspolicies-overview.md
+ - name: Authentication method policy
+ href: resources/authenticationmethodspolicy.md
+ items:
+ - name: Get
+ href: api/authenticationmethodspolicy-get.md
+ - name: Update
+ href: api/authenticationmethodspolicy-update.md
- name: FIDO2 policy href: resources/fido2authenticationmethodconfiguration.md items:
items:
items: - name: List href: api/accessreviewscheduledefinition-list.md
- - name: List instances
- href: api/accessreviewscheduledefinition-list-instances.md
- name: Get href: api/accessreviewscheduledefinition-get.md - name: Create