Updates from: 08/06/2022 01:14:12
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-get.md
GET /administrativeUnits/{id}
GET /directory/administrativeUnits/{id} ``` ## Optional query parameters
-This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
-
-### Retrieve extensions and associated data
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
v1.0 Authenticationmethodsroot List Userregistrationdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/authenticationmethodsroot-list-userregistrationdetails.md
Content-Type: application/json
"id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6", "userPrincipalName": "AlexW@Contoso.com", "userDisplayName": "Alex Wilber",
+ "isAdmin": false,
"isSsprRegistered": false, "isSsprEnabled": false, "isSsprCapable": false,
Content-Type: application/json
"microsoftAuthenticatorPush", "softwareOneTimePasscode" ],
- "defaultMethod": "microsoftAuthenticatorPush"
+ "defaultMethod": "microsoftAuthenticatorPush",
+ "userType": "member"
}, { "id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f", "userPrincipalName": "AllanD@Contoso.com", "userDisplayName": "Allan Deyoung",
+ "isAdmin": false,
"isSsprRegistered": false, "isSsprEnabled": false, "isSsprCapable": false,
Content-Type: application/json
"isMfaCapable": false, "isPasswordlessCapable": false, "methodsRegistered": [],
- "defaultMethod": ""
+ "defaultMethod": "",
+ "userType": "guest"
}, { "id": "c8096958-797c-44fa-8fde-a6fb62567cf0", "userPrincipalName": "BiancaP@Contoso.com", "userDisplayName": "Bianca Pisani",
+ "isAdmin": false,
"isSsprRegistered": true, "isSsprEnabled": false, "isSsprCapable": false,
Content-Type: application/json
"microsoftAuthenticatorPush", "softwareOneTimePasscode" ],
- "defaultMethod": "mobilePhone"
+ "defaultMethod": "mobilePhone",
+ "userType": "member"
} ] }
v1.0 Directory List Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-list-administrativeunits.md
GET /administrativeUnits
GET /directory/administrativeUnits ``` ## Optional query parameters
-This method supports the `$count`, `$select`, `$search`, `$filter`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
-
-### Retrieve extensions and associated data
+This method supports the `$count`, `$select`, `$search`, `$filter`, and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-get.md
GET /groups/{id}
## Optional query parameters
-You can use `$select` to get specific group properties, including those that are not returned by default.
-
-For more information on OData query options, see [OData Query Parameters](/graph/query-parameters).
-
-### Retrieve extensions and associated data
+You can use `$select` to get specific group properties, including those that are not returned by default. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|--|
For more information on OData query options, see [OData Query Parameters](/graph
| Open extensions | Returned through the [Get open extension](opentypeextension-get.md) operation. | | Directory extensions | Returned by default. |
+For more information on OData query options, see [OData Query Parameters](/graph/query-parameters).
+ ## Request headers | Name | Type | Description |
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md
To list only Microsoft 365 groups (aka unified groups), apply a filter on **grou
GET https://graph.microsoft.com/beta/groups?$filter=groupTypes/any(c:c+eq+'Unified') ```
-The `$search` query parameter supports tokenization only on the **displayName** and **description** fields and requires the **ConsistencyLevel** header. Fields other than **displayName** and **description** default to `$filter` `startswith` behavior.
+The `$search` query parameter supports tokenization only on the **displayName** and **description** fields and requires the **ConsistencyLevel** header. Fields other than **displayName** and **description** default to `$filter` `startsWith` behavior.
-For more information on OData query options, see [OData query parameters](/graph/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).
-
-### Retrieve extensions and associated data
+Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
For more information on OData query options, see [OData query parameters](/graph
| Open extensions | Returned only with `$expand`. | | Directory extensions | Returned by default. |
+For more information on OData query options, see [OData query parameters](/graph/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).
+ ## Request headers | Name | Description |
v1.0 Taskfileattachment Createuploadsession https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/taskfileattachment-createuploadsession.md
Content-Type: application/json
{ "attachmentInfo": {
- "@odata.type": "microsoft.graph.attachmentInfo",
"attachmentType": "file", "name": "flower", "size": 3483322
v1.0 User Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-get.md
GET /me
## Optional query parameters
-This method supports the `$select` [OData query parameter](/graph/query-parameters) to retrieve specific user properties, including those that are not returned by default.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to retrieve specific user properties, including those that are not returned by default. Extension properties also support query parameters as follows:
-### Retrieve extensions and associated data
-
-| Extension type | Comments |
-||-|
-| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. |
-| Schema extensions | Returned only with `$select`. |
+| Extension type | Comments |
+||-|
+| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. |
+| Schema extensions | Returned only with `$select`. |
| Open extensions | Returned only through the [Get open extension](opentypeextension-get.md) operation. |
-| Directory extensions | Returned only with `$select`. |
+| Directory extensions | Returned only with `$select`. |
## Request headers
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-list.md
GET /users
This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 user objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
-Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
+Extension properties also support query parameters as follows:
-The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
+| Extension type | Comments |
+||-|
+| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
+| Schema extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
+| Open extensions | Returned only with `$expand`, that is, `users?$expand=extensions`. |
+| Directory extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
-### Retrieve extensions and associated data
+Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
-| Extension type | Comments |
-|||
-| onPremisesExtensionAttributes 1-15 | Returned by default. Supports `$filter` (`eq`). |
-| Schema extensions | Returned only with `$select`. Supports `$filter` (`eq`). |
-| Open extensions | Returned only with `$expand`, that is, `users?$expand=extensions`. |
-| Directory extensions | Returned by default. Supports `$filter` (`eq`). |
+The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
## Request headers
v1.0 Userregistrationdetails Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/userregistrationdetails-get.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-GET /reports/authenticationMethods/userRegistrationDetails/{userRegistrationDetailsId}
+GET /reports/authenticationMethods/userRegistrationDetails/{userId}
``` ## Optional query parameters
Content-Type: application/json
"id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6", "userPrincipalName": "AlexW@Contoso.com", "userDisplayName": "Alex Wilber",
+ "isAdmin": false,
"isSsprRegistered": false, "isSsprEnabled": false, "isSsprCapable": false,
Content-Type: application/json
"microsoftAuthenticatorPush", "softwareOneTimePasscode" ],
- "defaultMfaMethod": "microsoftAuthenticatorPush"
+ "defaultMfaMethod": "microsoftAuthenticatorPush",
+ "userType": "member"
} } ```
v1.0 Directorysettingtemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/directorysettingtemplate.md
Namespace: microsoft.graph
Directory setting templates represent system-defined settings available to the tenant. [Directory settings](directorysetting.md) can be created based on the available **directorySettingTemplates**, and values changed from their preset defaults. Directory setting templates cannot be created, updated or deleted. These settings can represent tenant-wide settings, or can represent specific entity settings. Currently, the only templates available for groups apply to Microsoft 365 groups, and include settings such as whether users can create groups or invite guests from outside the organization to become members of a group.
-For more information about the available Microsoft 365 group settings, see [Template settings](/azure/active-directory/enterprise-users/groups-settings-cmdlets).
+For more information about each setting, see [group (directory) settings](/graph/group-directory-settings).
> [!TIP] > The `/v1.0` version of this resource is named [groupSettingTemplate](/graph/api/resources/groupsettingtemplate?view=graph-rest-1.0&preserve-view=true).
v1.0 Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/extensionproperty.md
Inherits from [directoryObject](directoryobject.md).
|dataType|String| Specifies the data type of the value the extension property can hold. Following values are supported. Not nullable. <ul><li>`Binary` - 256 bytes maximum</li><li>`Boolean`</li><li>`DateTime` - Must be specified in ISO 8601 format. Will be stored in UTC.</li><li>`Integer` - 32-bit value.</li><li>`LargeInteger` - 64-bit value.</li><li>`String` - 256 characters maximum</li></ul>| |deletedDateTime|DateTimeOffset|Date and time when this object was deleted. Always `null` when the object hasn't been deleted. Inherited from [directoryObject](directoryobject.md).| |isSyncedFromOnPremises|Boolean| Indicates if this extension property was synced from on-premises active directory using Azure AD Connect. Read-only. |
-|name|String| Name of the extension property. Not nullable. |
+|name|String| Name of the extension property. Not nullable. Supports `$filter` (`eq`).|
|targetObjects|String collection| Following values are supported. Not nullable. <ul><li>`User`</li><li>`Group`</li><li>`AdministrativeUnit`</li><li>`Application`</li><li>`Device`</li><li>`Organization`</li></ul>| ## Relationships
v1.0 Schemaextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/schemaextension.md
For more information about Microsoft Graph extensibility including limits for sc
| Property | Type |Description| |:|:--|:-| |description|String|Description for the schema extension. Supports `$filter` (`eq`).|
-|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). <br/><br> **Note:** We recommend that your **id** starts with an alphabetic letter between A-Z because query capabilities might be limited for IDs that begin with integers. |
+|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). <br/><br> **Note:** We recommend that your **id** starts with an alphabetic letter between A-Z because query capabilities might be limited for IDs that begin with integers. <br/><br/> Supports `$filter` (`eq`).|
|owner|String| The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed. Supports `$filter` (`eq`).| |properties|[extensionSchemaProperty](extensionschemaproperty.md) collection|The collection of property names and types that make up the schema extension definition.| |status|String|The lifecycle state of the schema extension. Possible states are `InDevelopment`, `Available`, and `Deprecated`. Automatically set to `InDevelopment` on creation. For more information about the possible state transitions and behaviors, see [Schema extensions lifecycle](#schema-extensions-lifecycle). Supports `$filter` (`eq`).|
v1.0 Userregistrationdetails https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/userregistrationdetails.md
Inherits from [entity](../resources/entity.md).
|:|:|:| |defaultMfaMethod|defaultMfaMethodType|The method the user or admin selected as default for performing multi-factor authentication for the user. The possible values are: `none`, `mobilePhone`, `alternateMobilePhone`, `officePhone`, `microsoftAuthenticatorPush`, `softwareOneTimePasscode`, `unknownFutureValue`.| |id|String|User object identifier in Azure AD. Inherited from [entity](../resources/entity.md).|
+|isAdmin|Boolean|Whether the user has an admin role in the tenant. This value can be used to check the authentication methods that privileged accounts are registered for and capable of.|
|isMfaCapable|Boolean|Whether the user has registered a strong authentication method for multi-factor authentication. The method must be allowed by the [authentication methods policy](../resources/authenticationmethodspolicy.md). Supports `$filter` (`eq`).| |isMfaRegistered|Boolean|Whether the user has registered a strong authentication method for multi-factor authentication. The method may not necessarily be allowed by the [authentication methods policy](../resources/authenticationmethodspolicy.md). Supports `$filter` (`eq`).| |isPasswordlessCapable|Boolean|Whether the user has registered a passwordless strong authentication method (including FIDO2, Windows Hello for Business, and Microsoft Authenticator (Passwordless)) that is allowed by the [authentication methods policy](../resources/authenticationmethodspolicy.md). Supports `$filter` (`eq`).|
Inherits from [entity](../resources/entity.md).
|methodsRegistered|String collection|Collection of authentication methods registered, such as `mobilePhone`, `email`, `fido2`. Supports `$filter` (`any` with `eq`).| |userDisplayName|String| The user display name, such as `Adele Vance`. Supports `$filter` (`eq`, `startsWith`) and `$orderBy`.| |userPrincipalName|String|The user principal name, such as `AdeleV@contoso.com`. Supports `$filter` (`eq`, `startsWith`) and `$orderBy`.|
+|userType|signInUserType|Identifies whether the user is a member or guest in the tenant. The possible values are: `member`, `guest`, `unknownFutureValue`.|
## Relationships None.
v1.0 Administrativeunit Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/administrativeunit-get.md
One of the following permissions is required to call this API. To learn more, in
GET /directory/administrativeUnits/{id} ``` ## Optional query parameters
-This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
-
-### Retrieve extensions and associated data
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
v1.0 Directory List Administrativeunits https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/directory-list-administrativeunits.md
One of the following permissions is required to call this API. To learn more, in
GET /directory/administrativeUnits ``` ## Optional query parameters
-This method supports the `$count`, `$select`, `$search`, `$filter` (`eq`), and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response.
-
-### Retrieve extensions and associated data
+This method supports the `$count`, `$select`, `$search`, `$filter` (`eq`), and `$expand` [OData query parameters](/graph/query-parameters) to help customize the response. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-get.md
GET /groups/{id}
## Optional query parameters
-You can use `$select` to get specific group properties, including those that are not returned by default.
-
-For more information on OData query options, see [OData Query Parameters](/graph/query-parameters).
-
-### Retrieve extensions and associated data
+You can use `$select` to get specific group properties, including those that are not returned by default. Extension properties also support query parameters as follows:
| Extension type | Comments | |-|--|
For more information on OData query options, see [OData Query Parameters](/graph
| Open extensions | Returned through the [Get open extension](opentypeextension-get.md) operation. | | Directory extensions | Returned by default. |
+For more information on OData query options, see [OData Query Parameters](/graph/query-parameters).
+ ## Request headers | Name | Type | Description |
Content-type: application/json
"deletedDateTime": null, "classification": null, "createdDateTime": "2017-07-31T18:56:16Z",
- "creationOptions": [
- "ExchangeProvisioningFlags:481"
- ],
"description": "Welcome to the HR Taskforce team.", "displayName": "HR Taskforce", "expirationDateTime": null,
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-list.md
GET https://graph.microsoft.com/v1.0/groups?$filter=groupTypes/any(c:c+eq+'Unifi
The `$search` query parameter supports tokenization only on the **displayName** and **description** fields and requires the **ConsistencyLevel** header. Fields other than **displayName** and **description** default to `$filter` `startswith` behavior.
-For more information on OData query options, see [OData query parameters](/graph/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).
-
-### Retrieve extensions and associated data
+Extension properties also support query parameters as follows:
| Extension type | Comments | |-|-|
For more information on OData query options, see [OData query parameters](/graph
| Open extensions | Returned only with `$expand`. | | Directory extensions | Returned by default. |
+For more information on OData query options, see [OData query parameters](/graph/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).
++ ## Request headers | Name | Description |
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-post-groups.md
Content-type: application/json
"deletedDateTime": null, "classification": null, "createdDateTime": "2018-12-22T00:51:37Z",
- "creationOptions": [],
"description": "Self help community for library", "displayName": "Library Assist", "groupTypes": [
Content-type: application/json
"deletedDateTime": null, "classification": null, "createdDateTime": "2021-09-21T07:09:14Z",
- "creationOptions": [],
"description": "Group with designated owner and members", "displayName": "Operations group", "expirationDateTime": null,
v1.0 Site List Permissions https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/site-list-permissions.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) | Not supported.
+|Delegated (work or school account) | Sites.FullControl.All
|Delegated (personal Microsoft account) | Not supported. |Application | Sites.FullControl.All
v1.0 User Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-get.md
By default, only a limited set of properties are returned ( _businessPhones, dis
To return an alternative property set, you must specify the desired set of [user](../resources/user.md) properties using the OData `$select` query parameter. For example, to return _displayName_, _givenName_, and _postalCode_, you would use the add the following to your query `$select=displayName,givenName,postalCode`.
-### Retrieve extensions and associated data
+Extension properties also support query parameters as follows:
-| Extension type | Comments |
-||-|
-| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. |
-| Schema extensions | Returned only with `$select`. |
+| Extension type | Comments |
+||-|
+| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. |
+| Schema extensions | Returned only with `$select`. |
| Open extensions | Returned only through the [Get open extension](opentypeextension-get.md) operation. |
-| Directory extensions | Returned only with `$select`. |
+| Directory extensions | Returned only with `$select`. |
## Request headers | Header | Value|
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/user-list.md
GET /users
## Optional query parameters
-This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response.`$skip` isn't supported. The default and maximum page sizes are 100 and 999 user objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
+This method supports the `$count`, `$expand`, `$filter`, `$orderBy`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. `$skip` isn't supported. The default and maximum page sizes are 100 and 999 user objects respectively. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries). The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
By default, only a limited set of properties are returned (**businessPhones**, **displayName**, **givenName**, **id**, **jobTitle**, **mail**, **mobilePhone**, **officeLocation**, **preferredLanguage**, **surname**, and **userPrincipalName**).To return an alternative property set, specify the desired set of [user](../resources/user.md) properties using the OData `$select` query parameter. For example, to return **displayName**, **givenName**, and **postalCode**, add the following to your query `$select=displayName,givenName,postalCode`.
-Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
+Extension properties also support query parameters as follows:
-The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
+| Extension type | Comments |
+||-|
+| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
+| Schema extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
+| Open extensions | Returned only with `$expand`, that is, `users?$expand=extensions`. |
+| Directory extensions | Returned only with `$select`. Supports `$filter` (`eq`, `ne`, and `eq` on `null` values). |
-### Retrieve extensions and associated data
+Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
-| Extension type | Comments |
-|||
-| onPremisesExtensionAttributes 1-15 | Returned only with `$select`. Supports `$filter` (`eq`). |
-| Schema extensions | Returned only with `$select`. Supports `$filter` (`eq`). |
-| Open extensions | Returned only with `$expand`, that is, `users?$expand=extensions`. |
-| Directory extensions | Returned only with `$select`. Supports `$filter` (`eq`). |
+The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
## Request headers
v1.0 Extensionproperty https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/extensionproperty.md
Inherits from [directoryObject](directoryobject.md).
|dataType|String| Specifies the data type of the value the extension property can hold. Following values are supported. Not nullable. <ul><li>`Binary` - 256 bytes maximum</li><li>`Boolean`</li><li>`DateTime` - Must be specified in ISO 8601 format. Will be stored in UTC.</li><li>`Integer` - 32-bit value.</li><li>`LargeInteger` - 64-bit value.</li><li>`String` - 256 characters maximum</li></ul>| |deletedDateTime|DateTimeOffset|Date and time when this object was deleted. Always `null` when the object hasn't been deleted. Inherited from [directoryObject](directoryobject.md).| |isSyncedFromOnPremises|Boolean| Indicates if this extension property was synced from on-premises active directory using Azure AD Connect. Read-only. |
-|name|String| Name of the extension property. Not nullable. |
+|name|String| Name of the extension property. Not nullable. Supports `$filter` (`eq`).|
|targetObjects|String collection| Following values are supported. Not nullable. <ul><li>`User`</li><li>`Group`</li><li>`AdministrativeUnit`</li><li>`Application`</li><li>`Device`</li><li>`Organization`</li></ul>| ## Relationships
v1.0 Groupsettingtemplate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/groupsettingtemplate.md
Namespace: microsoft.graph
Group setting templates represent system-defined settings available to the tenant. [Group settings](groupsetting.md) can be created based on the available **groupSettingTemplates**, and values changed from their preset defaults. Group setting templates cannot be created, updated or deleted. These settings can represent tenant-wide settings, or can represent specific group settings. Currently, the only templates available for groups apply to Microsoft 365 groups, and include settings such as whether users can create groups or invite guests from outside the organization to become members of a group.
-For more information about the available Microsoft 365 group settings, see [Template settings](/azure/active-directory/enterprise-users/groups-settings-cmdlets).
+For more information about each setting, see [group (directory) settings](/graph/group-directory-settings).
> [!TIP] > The `/beta` version of this resource is named [directorySettingTemplate](/graph/api/resources/directorysettingtemplate?view=graph-rest-beta&preserve-view=true).
v1.0 Schemaextension https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/schemaextension.md
For more information about Microsoft Graph extensibility including limits for sc
| Property | Type |Description| |:|:--|:-| |description|String|Description for the schema extension. Supports `$filter` (`eq`).|
-|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). **Note:** We recommend that your **id** starts with an alphabetic letter between A-Z because query capabilities might be limited for IDs that begin with integers. |
+|id|String|The unique identifier for the schema extension definition. <br>You can assign a value in one of two ways: <ul><li>Concatenate the name of one of your verified domains with a name for the schema extension to form a unique string in this format, \{_&#65279;domainName_\}\_\{_&#65279;schemaName_\}. As an example, `contoso_mySchema`. </li><li>Provide a schema name, and let Microsoft Graph use that schema name to complete the **id** assignment in this format: ext\{_&#65279;8-random-alphanumeric-chars_\}\_\{_&#65279;schema-name_\}. An example would be `extkvbmkofy_mySchema`.</li></ul>This property cannot be changed after creation. Supports `$filter` (`eq`). **Note:** We recommend that your **id** starts with an alphabetic letter between A-Z because query capabilities might be limited for IDs that begin with integers. <br/><br/> Supports `$filter` (`eq`). |
|owner|String|The `appId` of the application that is the owner of the schema extension. This property can be supplied on creation, to set the owner. If not supplied, then the calling application's `appId` will be set as the owner. In either case, the signed-in user must be the owner of the application. So, for example, if creating a new schema extension definition using Graph Explorer, you **must** supply the owner property. Once set, this property is read-only and cannot be changed. Supports `$filter` (`eq`).| |properties|[extensionSchemaProperty](extensionschemaproperty.md) collection|The collection of property names and types that make up the schema extension definition.| |status|String|The lifecycle state of the schema extension. Possible states are `InDevelopment`, `Available`, and `Deprecated`. Automatically set to `InDevelopment` on creation. For more information about the possible state transitions and behaviors, see [Schema extensions lifecycle](#schema-extensions-lifecycle). Supports `$filter` (`eq`).|