diff --git a/.azure-pipelines/common-templates/install-tools.yml b/.azure-pipelines/common-templates/install-tools.yml
index 0b64943de1..0e8feaf9fd 100644
--- a/.azure-pipelines/common-templates/install-tools.yml
+++ b/.azure-pipelines/common-templates/install-tools.yml
@@ -5,7 +5,12 @@ steps:
- task: UseDotNet@2
displayName: Use .NET SDK
inputs:
- version: 8.x
+ version: 10.x
+
+ - task: UseDotNet@2
+ displayName: Use .NET SDK
+ inputs:
+ version: 8.x
- task: UseDotNet@2
displayName: Use .NET SDK
diff --git a/.azure-pipelines/docker-image-refresh.yml b/.azure-pipelines/docker-image-refresh.yml
index ce5ff5b745..59294a3688 100644
--- a/.azure-pipelines/docker-image-refresh.yml
+++ b/.azure-pipelines/docker-image-refresh.yml
@@ -15,12 +15,16 @@
name: $(Date:yyyyMMdd)$(Rev:.r)_docker-image-refresh
parameters:
+- name: WindowsPool
+ type: string
+ default: 1es-windows-ps-compute-m
- name: LinuxPool
type: string
default: Azure-Pipelines-1ESPT-ExDShared
variables:
REGISTRY: 'msgraphprodregistry.azurecr.io'
+ REGISTRY_NAME: 'msgraphprodregistry' # ACR resource name (az acr build uses this, not the FQDN)
IMAGE_NAME: 'public/microsoftgraph/powershell'
# Rebuild weekly so the image regularly picks up patched OS layers. `always: true` forces a run
@@ -47,10 +51,10 @@ resources:
extends:
template: v1/1ES.Official.PipelineTemplate.yml@1ESPipelineTemplates
parameters:
- pool:
- name: ${{ parameters.LinuxPool }}
- image: ubuntu-latest
- os: linux
+ # The 1ES template injects an SDL/compliance stage that MUST run on a Windows pool, so the
+ # template-level pool is Windows. The actual container build overrides to a Linux pool at the
+ # job level below. (Same pattern as sdk-release.yml.)
+ pool: ${{ parameters.WindowsPool }}
settings:
networkIsolationPolicy: Permissive
customBuildTags:
@@ -68,31 +72,22 @@ extends:
steps:
- checkout: self
+ # Build server-side with ACR Tasks: no local Docker daemon, no buildx/QEMU, and no
+ # Docker Hub dependency (which the network-isolated 1ES pool can't reach). ACR pulls the
+ # base image from MCR and pushes the result back to the registry.
- task: AzureCLI@2
- displayName: 'Log in to Azure Container Registry'
+ displayName: 'Build and push patched image (ACR Tasks)'
inputs:
azureSubscription: 'ACR Images Push Service Connection'
scriptType: 'bash'
scriptLocation: 'inlineScript'
inlineScript: |
- az acr login --name $(REGISTRY)
-
- - script: |
- docker run --privileged --rm tonistiigi/binfmt --install all
- displayName: 'Enable multi-platform builds'
-
- - script: |
- docker buildx create --use --name refreshbuilder
- displayName: 'Set up Docker BuildX'
-
- - bash: |
- set -euo pipefail
- formatted_date=$(date +"%Y%m%d%H%M%S")
- echo "Rebuilding $(REGISTRY)/$(IMAGE_NAME) on a patched base"
- docker buildx build \
- --platform linux/amd64 \
- --push \
- -t "$(REGISTRY)/$(IMAGE_NAME):latest" \
- -t "$(REGISTRY)/$(IMAGE_NAME):$formatted_date" \
- "$(Build.SourcesDirectory)"
- displayName: 'Build and push refreshed image'
+ set -euo pipefail
+ formatted_date=$(date +"%Y%m%d%H%M%S")
+ echo "Rebuilding $(REGISTRY_NAME) / $(IMAGE_NAME) on a patched base via ACR Tasks"
+ az acr build \
+ --registry $(REGISTRY_NAME) \
+ --image "$(IMAGE_NAME):latest" \
+ --image "$(IMAGE_NAME):$formatted_date" \
+ --platform linux/amd64 \
+ "$(Build.SourcesDirectory)"
diff --git a/.gitignore b/.gitignore
index 3e41c4492f..137e52d5d1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -61,6 +61,7 @@ BenchmarkDotNet.Artifacts/
project.lock.json
project.fragment.lock.json
artifacts/
+sweep_results.json
# StyleCop
StyleCopReport.xml
diff --git a/openApiDocs/beta/Applications.yml b/openApiDocs/beta/Applications.yml
index 35b2eef603..929469d4b3 100644
--- a/openApiDocs/beta/Applications.yml
+++ b/openApiDocs/beta/Applications.yml
@@ -3406,7 +3406,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action pause
- description: 'Temporarily stop a running synchronization job. All the progress, including job state, is persisted, and the job continues from where it left off when a start call is made.'
+ description: 'Temporarily stop a running synchronizationJob. All the progress, including job state, is persisted, and the job continues from where it left off when a start call is made.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-pause?view=graph-rest-beta
@@ -3439,7 +3439,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action provisionOnDemand
- description: Select a user and provision the account on-demand. The rate limit for this API is 5 requests per 10 seconds. No user or group will be provisioned on-demand that would not have been provisioned through the regular provisioning cycles.
+ description: Select a user and provision the account on-demand for a synchronizationJob. The rate limit for this API is 5 requests per 10 seconds. No user or group will be provisioned on-demand that would not have been provisioned through the regular provisioning cycles.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-provisionondemand?view=graph-rest-beta
@@ -3490,7 +3490,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action restart
- description: 'Restart a stopped synchronization job, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
+ description: 'Restart a stopped synchronizationJob, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-restart?view=graph-rest-beta
@@ -3535,7 +3535,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action start
- description: 'Start an existing synchronization job. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
+ description: 'Start an existing synchronizationJob. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-start?view=graph-rest-beta
@@ -3568,7 +3568,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action validateCredentials
- description: Validate that the credentials are valid in the tenant.
+ description: Validate that the credentials are valid in the tenant for a synchronizationJob.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-validatecredentials?view=graph-rest-beta
@@ -4016,7 +4016,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: 'Discover the latest schema for a directoryDefinition to provision to an application. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-beta
@@ -4091,7 +4091,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-beta
@@ -4177,7 +4177,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-beta
@@ -4263,7 +4263,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-beta
@@ -4390,7 +4390,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action acquireAccessToken
- description: Acquire an OAuth Access token to authorize the Microsoft Entra provisioning service to provision users into an application.
+ description: Acquire an OAuth access token from the synchronization resource to authorize the Microsoft Entra provisioning service to provision users into an application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-acquireaccesstoken?view=graph-rest-beta
@@ -4689,7 +4689,7 @@ paths:
tags:
- applications.synchronization
summary: Update synchronizationTemplate
- description: Update (override) the synchronization template associated with a given application.
+ description: Update (override) the synchronizationTemplate associated with a given application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationtemplate-update?view=graph-rest-beta
@@ -5152,7 +5152,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: 'Discover the latest schema for a directoryDefinition to provision to an application. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-beta
@@ -5227,7 +5227,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-beta
@@ -5313,7 +5313,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-beta
@@ -5399,7 +5399,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-beta
@@ -6549,6 +6549,41 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /applicationTemplates/microsoft.graph.categories():
+ get:
+ tags:
+ - applicationTemplates.applicationTemplate.Functions
+ summary: Invoke function categories
+ operationId: applicationTemplate_category
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.applicationTemplateCategory'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
'/groups/{group-id}/appRoleAssignments':
get:
tags:
@@ -17997,7 +18032,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: List synchronization jobs
- description: List existing jobs for a given application instance (service principal).
+ description: List existing synchronizationJob objects for a given application instance (service principal).
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-list-jobs?view=graph-rest-beta
@@ -18059,7 +18094,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Create synchronizationJob
- description: Create new synchronization job with a default synchronization schema. The job is created in a disabled state. Call Start job to start synchronization.
+ description: Create a new synchronizationJob with a default synchronization schema. The job is created in a disabled state. Call Start job to start synchronization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-post-jobs?view=graph-rest-beta
@@ -18095,7 +18130,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Get synchronizationJob
- description: Retrieve the existing synchronization job and its properties.
+ description: Retrieve an existing synchronizationJob and its properties.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-get?view=graph-rest-beta
@@ -18190,7 +18225,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Delete synchronizationJob
- description: 'Stop the synchronization job, and permanently delete all the state associated with it. Synchronized accounts are left as-is.'
+ description: 'Stop the synchronizationJob, and permanently delete all the state associated with it. Synchronized accounts are left as-is.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-delete?view=graph-rest-beta
@@ -18460,7 +18495,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action pause
- description: 'Temporarily stop a running synchronization job. All the progress, including job state, is persisted, and the job continues from where it left off when a start call is made.'
+ description: 'Temporarily stop a running synchronizationJob. All the progress, including job state, is persisted, and the job continues from where it left off when a start call is made.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-pause?view=graph-rest-beta
@@ -18493,7 +18528,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action provisionOnDemand
- description: Select a user and provision the account on-demand. The rate limit for this API is 5 requests per 10 seconds. No user or group will be provisioned on-demand that would not have been provisioned through the regular provisioning cycles.
+ description: Select a user and provision the account on-demand for a synchronizationJob. The rate limit for this API is 5 requests per 10 seconds. No user or group will be provisioned on-demand that would not have been provisioned through the regular provisioning cycles.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-provisionondemand?view=graph-rest-beta
@@ -18544,7 +18579,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action restart
- description: 'Restart a stopped synchronization job, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
+ description: 'Restart a stopped synchronizationJob, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-restart?view=graph-rest-beta
@@ -18589,7 +18624,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action start
- description: 'Start an existing synchronization job. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
+ description: 'Start an existing synchronizationJob. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-start?view=graph-rest-beta
@@ -18622,7 +18657,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action validateCredentials
- description: Validate that the credentials are valid in the tenant.
+ description: Validate that the credentials are valid in the tenant for a synchronizationJob.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-validatecredentials?view=graph-rest-beta
@@ -18685,7 +18720,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Get synchronizationSchema
- description: Retrieve the schema for a given synchronization job or template.
+ description: Retrieve the synchronizationSchema for a given synchronization job or template.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-get?view=graph-rest-beta
@@ -18741,7 +18776,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Update synchronizationSchema
- description: 'Update the synchronization schema for a given job or template. This method fully replaces the current schema with the one provided in the request. To update the schema of a template, make the call on the application object. You must be the owner of the application.'
+ description: 'Update the synchronizationSchema for a given job or template. This method fully replaces the current schema with the one provided in the request. To update the schema of a template, make the call on the application object. You must be the owner of the application.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-update?view=graph-rest-beta
@@ -19077,7 +19112,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: 'Discover the latest schema for a directoryDefinition to provision to an application. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-beta
@@ -19152,7 +19187,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-beta
@@ -19238,7 +19273,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-beta
@@ -19324,7 +19359,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-beta
@@ -19451,7 +19486,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action acquireAccessToken
- description: Acquire an OAuth Access token to authorize the Microsoft Entra provisioning service to provision users into an application.
+ description: Acquire an OAuth access token from the synchronization resource to authorize the Microsoft Entra provisioning service to provision users into an application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-acquireaccesstoken?view=graph-rest-beta
@@ -19527,7 +19562,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Add synchronization secrets
- description: Provide credentials for establishing connectivity with the target system.
+ description: Provide credentials for establishing connectivity with the target system and store them in the synchronization resource.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-serviceprincipal-put-synchronization?view=graph-rest-beta
@@ -19610,7 +19645,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: List existing synchronization templates
- description: List the synchronization templates associated with a given application or service principal.
+ description: List synchronizationTemplate objects associated with a given application or service principal.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-list-templates?view=graph-rest-beta
@@ -20216,7 +20251,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: 'Discover the latest schema for a directoryDefinition to provision to an application. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-beta
@@ -20291,7 +20326,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-beta
@@ -20377,7 +20412,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-beta
@@ -20463,7 +20498,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-beta
@@ -23017,7 +23052,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -23044,7 +23079,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -23209,7 +23244,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -23231,7 +23266,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -23266,7 +23301,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -23370,7 +23405,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -23503,6 +23538,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -24044,7 +24085,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of categories for the application. Supported values can be: Collaboration, Business Management, Consumer, Content management, CRM, Data services, Developer services, E-commerce, Education, ERP, Finance, Health, Human resources, IT infrastructure, Mail, Management, Marketing, Media, Productivity, Project management, Telecommunications, Tools, Travel, and Web design & hosting. Supports $filter (contains).'
+ description: 'The list of categories for the application. To get the full list of supported values, use the applicationTemplate: categories function. Supports $filter (contains).'
configurationUris:
type: array
items:
@@ -24123,6 +24164,18 @@ components:
$ref: '#/components/schemas/microsoft.graph.servicePrincipal'
additionalProperties:
type: object
+ microsoft.graph.applicationTemplateCategory:
+ title: applicationTemplateCategory
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: 'The localizable display name of the category, suitable for showing in a UI.'
+ value:
+ type: string
+ description: The category value as it appears in the categories property of an applicationTemplate. Use this value when filtering application templates by category.
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesPublishingProfile:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -24511,7 +24564,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -24543,7 +24596,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -24910,7 +24963,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.selfSignedCertificate:
title: selfSignedCertificate
type: object
@@ -25437,6 +25489,8 @@ components:
type: boolean
description: Locks the keyCredentials and passwordCredentials properties for modification where credential usage type is Verify. This locks OAuth service principals.
nullable: true
+ enforcementScope:
+ $ref: '#/components/schemas/microsoft.graph.servicePrincipalLockScope'
isEnabled:
type: boolean
description: 'Enables or disables service principal lock configuration. To allow the sensitive properties to be updated, update this property to false to disable the lock on the service principal.'
@@ -26942,6 +26996,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -27573,6 +27629,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -27648,7 +27738,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -28999,7 +29088,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -29049,6 +29137,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -30258,6 +30351,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -31116,6 +31210,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.servicePrincipalLockScope:
+ title: servicePrincipalLockScope
+ enum:
+ - notConfigured
+ - foreignTenantOnly
+ - everywhere
+ - unknownFutureValue
+ type: string
microsoft.graph.kind:
title: kind
enum:
@@ -31178,7 +31280,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -31244,6 +31346,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -32480,7 +32585,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -32496,13 +32601,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -32632,7 +32737,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -32950,6 +33055,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -33366,6 +33473,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -33535,6 +33686,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -33914,7 +34067,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -33928,6 +34081,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -34599,7 +34756,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -34751,7 +34908,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -37268,6 +37425,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -37629,6 +37788,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -37717,6 +37892,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -37966,6 +38146,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -39956,6 +40141,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -41170,6 +41358,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -41419,8 +41616,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -41510,6 +41705,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -41900,6 +42120,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -41918,7 +42150,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -44926,12 +45157,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -44965,6 +45199,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -45257,22 +45501,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -45588,6 +45816,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -46226,7 +46477,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -46612,6 +46863,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -48118,6 +48370,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -48339,28 +48593,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -48379,6 +48611,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -50241,6 +50481,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -50967,16 +51223,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -50995,20 +51254,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -51027,16 +51290,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -51055,16 +51321,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -51085,10 +51354,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -52521,6 +52792,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -52579,14 +52858,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -53307,6 +53578,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -53317,10 +53589,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -53331,6 +53605,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -53341,6 +53616,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -53349,10 +53625,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.printMargin:
@@ -53547,6 +53825,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -53561,6 +53842,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/BackupRestore.yml b/openApiDocs/beta/BackupRestore.yml
index be7c239728..f5ac643854 100644
--- a/openApiDocs/beta/BackupRestore.yml
+++ b/openApiDocs/beta/BackupRestore.yml
@@ -12500,8 +12500,10 @@ components:
$ref: '#/components/schemas/microsoft.graph.restorableArtifact'
queryExpression:
type: string
- description: Specifies criteria to retrieve artifacts.
+ description: 'Deprecated. Going forward, use the structuredQueryExpression property instead. Specifies criteria to retrieve artifacts.'
nullable: true
+ structuredQueryExpression:
+ $ref: '#/components/schemas/microsoft.graph.restoreSearchArtifactQueryExpression'
additionalProperties:
type: object
microsoft.graph.restorePointSearchResponse:
@@ -13141,6 +13143,8 @@ components:
nullable: true
destinationType:
$ref: '#/components/schemas/microsoft.graph.destinationType'
+ error:
+ $ref: '#/components/schemas/microsoft.graph.publicError'
restoredItemKey:
type: string
description: The unique identifier for the restored artifact.
@@ -13346,6 +13350,39 @@ components:
- message
- unknownFutureValue
type: string
+ microsoft.graph.restoreSearchArtifactQueryExpression:
+ title: restoreSearchArtifactQueryExpression
+ type: object
+ properties:
+ hasAttachment:
+ type: boolean
+ description: Indicates whether the artifact has an attachment. Optional.
+ nullable: true
+ items:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.granularRestoreItems'
+ description: The types of items to include in the search. Optional.
+ recipients:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The recipient email addresses to filter by. Optional.
+ senders:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The sender email addresses to filter by. Optional.
+ subjects:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The subject lines to filter by. Optional.
+ additionalProperties:
+ type: object
microsoft.graph.restorePointSearchResult:
title: restorePointSearchResult
type: object
@@ -14099,6 +14136,16 @@ components:
- completed
- unknownFutureValue
type: string
+ microsoft.graph.granularRestoreItems:
+ title: granularRestoreItems
+ enum:
+ - email
+ - note
+ - contact
+ - task
+ - calendar
+ - unknownFutureValue
+ type: string
microsoft.graph.ODataErrors.MainError:
required:
- code
diff --git a/openApiDocs/beta/Bookings.yml b/openApiDocs/beta/Bookings.yml
index 3a71c24979..af7a824a7b 100644
--- a/openApiDocs/beta/Bookings.yml
+++ b/openApiDocs/beta/Bookings.yml
@@ -13917,6 +13917,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -15054,6 +15055,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -16586,19 +16589,19 @@ components:
completeAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: DateTime after which the migration should be performed
+ description: 'Date and time after which the migration should be performed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.'
format: date-time
createdBy:
type: string
- description: ID of the user that created the job
+ description: User principal name (UPN) of the user who created the job. Read-only.
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: When the job what created
+ description: 'When the job was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.'
format: date-time
displayName:
type: string
- description: Display name of the job. Must be unique per tenant
+ description: Display name of the job. Must be unique per tenant.
exchangeSettings:
$ref: '#/components/schemas/microsoft.graph.exchangeOnlineCrossTenantMigrationSettings'
jobType:
@@ -16606,38 +16609,38 @@ components:
lastUpdatedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: When this migration job was last updated
+ description: 'When this migration job was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.'
format: date-time
message:
type: string
- description: Status message of the migration job
+ description: Status message of the migration job. Nullable. Read-only.
nullable: true
resources:
type: array
items:
type: string
- description: IDs (GUID) of the resources being migrated with the migration job
+ description: IDs (GUID) of the resources that are migrated with the migration job.
resourceType:
type: string
- description: Type of resource being migrated. Only Users is currently supported
+ description: Type of resource being migrated. Only Users is currently supported.
sourceTenantId:
type: string
- description: ID (GUID) of the tenant that content is being migrated from
+ description: ID (GUID) of the tenant that content is migrated from.
status:
$ref: '#/components/schemas/microsoft.graph.crossTenantMigrationJobStatus'
targetTenantId:
type: string
- description: ID of the tenant that content is being migrated to
+ description: ID of the tenant that content is migrated to. Read-only.
workloads:
type: array
items:
type: string
- description: 'Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint)'
+ description: 'Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint).'
users:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.crossTenantMigrationTask'
- description: Details and status of the users being migrated in this migration job
+ description: Details and status of the users migrated in this migration job.
x-ms-navigationProperty: true
additionalProperties:
type: object
@@ -16790,12 +16793,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -16829,6 +16835,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -17990,6 +18006,8 @@ components:
nullable: true
destinationType:
$ref: '#/components/schemas/microsoft.graph.destinationType'
+ error:
+ $ref: '#/components/schemas/microsoft.graph.publicError'
restoredItemKey:
type: string
description: The unique identifier for the restored artifact.
diff --git a/openApiDocs/beta/Calendar.yml b/openApiDocs/beta/Calendar.yml
index 55a52d2b9c..8b01cbfc54 100644
--- a/openApiDocs/beta/Calendar.yml
+++ b/openApiDocs/beta/Calendar.yml
@@ -21450,7 +21450,6 @@ components:
description: 'A short, friendly name for the room, often used for easier identification or display in UI.'
placeId:
type: string
- description: An alternative immutable unique identifier of the room. Read-only.
nullable: true
teamsEnabledState:
$ref: '#/components/schemas/microsoft.graph.placeFeatureEnablement'
@@ -21525,7 +21524,6 @@ components:
description: 'A short, friendly name for the workspace, often used for easier identification or display in the UI.'
placeId:
type: string
- description: An alternative immutable unique identifier of the workspace. Read-only.
nullable: true
additionalProperties:
type: object
diff --git a/openApiDocs/beta/ChangeNotifications.yml b/openApiDocs/beta/ChangeNotifications.yml
index 9fc6ad201d..a9b712faa0 100644
--- a/openApiDocs/beta/ChangeNotifications.yml
+++ b/openApiDocs/beta/ChangeNotifications.yml
@@ -308,6 +308,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.entity:
diff --git a/openApiDocs/beta/Compliance.yml b/openApiDocs/beta/Compliance.yml
index 93fc00e7b0..d9ead892c9 100644
--- a/openApiDocs/beta/Compliance.yml
+++ b/openApiDocs/beta/Compliance.yml
@@ -9697,7 +9697,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -10064,7 +10064,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.ediscovery.userSource:
allOf:
- $ref: '#/components/schemas/microsoft.graph.ediscovery.dataSource'
@@ -10628,7 +10627,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -10655,7 +10654,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -10820,7 +10819,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -10842,7 +10841,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -10877,7 +10876,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -10981,7 +10980,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -11114,6 +11113,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -11810,7 +11815,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -11824,6 +11829,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -12381,6 +12390,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -14525,6 +14535,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -15156,6 +15168,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -15177,7 +15223,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -16242,7 +16287,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -16281,6 +16325,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -17069,7 +17118,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -17299,7 +17348,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -18304,6 +18353,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -18673,6 +18724,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.notebook:
@@ -19224,6 +19287,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -19622,6 +19688,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -20924,7 +20995,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -20940,13 +21011,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -21038,7 +21109,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -21356,6 +21427,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -21772,6 +21845,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -24053,6 +24170,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -24414,6 +24533,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -24502,6 +24637,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -26681,8 +26821,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -26772,6 +26910,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -27098,7 +27261,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -27714,6 +27876,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -28050,6 +28215,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.userSet:
title: userSet
type: object
@@ -28249,7 +28437,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -29074,6 +29262,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -30604,12 +30801,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -30643,6 +30843,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -30935,22 +31145,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -31780,7 +31974,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -32166,6 +32360,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -32834,28 +33029,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -32874,6 +33047,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -33652,6 +33833,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.expirationPattern:
title: expirationPattern
type: object
@@ -34653,6 +34850,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -36055,14 +36254,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.scheduleEntityTheme'
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -38114,6 +38305,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -39021,16 +39220,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -39049,20 +39251,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -39081,16 +39287,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -39109,16 +39318,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -39139,10 +39351,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -39323,6 +39537,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -39337,6 +39554,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -39595,6 +39819,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -39605,10 +39830,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -39619,6 +39846,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -39629,6 +39857,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -39637,10 +39866,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/CrossDeviceExperiences.yml b/openApiDocs/beta/CrossDeviceExperiences.yml
index 7ef725f350..b4d46b0001 100644
--- a/openApiDocs/beta/CrossDeviceExperiences.yml
+++ b/openApiDocs/beta/CrossDeviceExperiences.yml
@@ -5908,7 +5908,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -6275,7 +6275,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.appRoleAssignment:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
@@ -6640,7 +6639,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -6667,7 +6666,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -6832,7 +6831,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -6854,7 +6853,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -6889,7 +6888,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -6993,7 +6992,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -7126,6 +7125,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -7526,6 +7531,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -9769,6 +9775,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -10176,6 +10184,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -10197,7 +10239,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -11230,7 +11271,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -11269,6 +11309,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -12049,6 +12094,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -12592,6 +12640,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -12995,6 +13045,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -13161,7 +13216,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -13175,6 +13230,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -13656,7 +13715,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -13886,7 +13945,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -14156,7 +14215,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -15161,7 +15220,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -15177,13 +15236,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -15275,7 +15334,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -15593,6 +15652,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -15923,6 +15984,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -18332,6 +18437,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -18693,6 +18800,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -18781,6 +18904,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -20070,6 +20198,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -20537,8 +20668,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -20628,6 +20757,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -21018,6 +21172,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -21036,7 +21202,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -21356,6 +21521,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.siteArchivalDetails:
title: siteArchivalDetails
type: object
@@ -23696,6 +23884,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -25390,12 +25587,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -25429,6 +25629,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -25721,22 +25931,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -26566,7 +26760,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -26952,6 +27146,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -27340,28 +27535,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -27380,6 +27553,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -27919,6 +28100,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.siteArchiveStatus:
title: siteArchiveStatus
enum:
@@ -29729,6 +29926,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -31143,14 +31342,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -31776,16 +31967,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -31804,20 +31998,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -31836,16 +32034,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -31864,16 +32065,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -31894,10 +32098,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -33420,6 +33626,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -34090,6 +34304,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -34100,10 +34315,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -34114,6 +34331,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -34124,6 +34342,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -34132,10 +34351,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
@@ -34445,6 +34666,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -34459,6 +34683,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/DeviceManagement.Enrollment.yml b/openApiDocs/beta/DeviceManagement.Enrollment.yml
index b4fadbb518..78729506be 100644
--- a/openApiDocs/beta/DeviceManagement.Enrollment.yml
+++ b/openApiDocs/beta/DeviceManagement.Enrollment.yml
@@ -6044,12 +6044,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.roleManagement'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -6072,12 +6066,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.roleManagement'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/cloudPC:
get:
@@ -6115,12 +6103,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.rbacApplicationMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -6143,12 +6125,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.rbacApplicationMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -6167,12 +6143,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/cloudPC/resourceNamespaces:
get:
@@ -6221,12 +6191,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceNamespaceCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -6252,12 +6216,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}':
get:
@@ -6303,12 +6261,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -6340,12 +6292,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -6372,12 +6318,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/microsoft.graph.importResourceActions':
post:
@@ -6420,12 +6360,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: action
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions':
get:
@@ -6483,12 +6417,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceActionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -6523,12 +6451,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}':
get:
@@ -6583,12 +6505,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -6628,12 +6544,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -6668,12 +6578,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/authenticationContext':
get:
@@ -6727,12 +6631,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.authenticationContextClassReference'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/resourceScope':
get:
@@ -6786,12 +6684,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -6831,12 +6723,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -6871,12 +6757,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/$count':
get:
@@ -6900,12 +6780,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/cloudPC/resourceNamespaces/$count:
get:
tags:
@@ -6920,12 +6794,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/cloudPC/roleAssignments:
get:
tags:
@@ -6974,12 +6842,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleAssignmentMultipleCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -7009,12 +6871,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}':
get:
@@ -7064,18 +6920,12 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
- roleManagement.rbacApplicationMultiple
summary: Update unifiedRoleAssignmentMultiple
- description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment does not support update."
+ description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment doesn't support update."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-update?view=graph-rest-beta
@@ -7105,12 +6955,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -7141,12 +6985,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes':
get:
@@ -7204,12 +7042,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.appScopeCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -7244,12 +7076,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes/{appScope-id}':
get:
@@ -7304,12 +7130,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -7349,12 +7169,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -7389,12 +7203,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes/$count':
get:
@@ -7418,12 +7226,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/directoryScopes':
get:
tags:
@@ -7480,12 +7282,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -7543,12 +7339,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/directoryScopes/$count':
get:
@@ -7572,12 +7362,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/principals':
get:
tags:
@@ -7634,12 +7418,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -7697,12 +7475,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/principals/$count':
get:
@@ -7726,12 +7498,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/cloudPC/roleAssignments/{unifiedRoleAssignmentMultiple-id}/roleDefinition':
get:
tags:
@@ -7777,12 +7543,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/cloudPC/roleAssignments/$count:
get:
@@ -7798,12 +7558,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/cloudPC/roleDefinitions:
get:
tags:
@@ -7855,12 +7609,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -7890,12 +7638,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleDefinitions/{unifiedRoleDefinition-id}':
get:
@@ -7945,12 +7687,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -7986,12 +7722,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -8022,12 +7752,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom':
get:
@@ -8085,12 +7809,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -8125,12 +7843,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}':
get:
@@ -8185,12 +7897,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -8230,12 +7936,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -8270,12 +7970,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/cloudPC/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
@@ -8381,12 +8075,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -8413,12 +8101,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/cloudPC/roleDefinitions/{unifiedRoleDefinition-id}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
tags:
@@ -8515,12 +8197,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -8539,12 +8215,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/deviceManagement:
get:
tags:
@@ -8582,12 +8252,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.rbacApplicationMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -8610,12 +8274,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.rbacApplicationMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -8634,12 +8292,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/deviceManagement/resourceNamespaces:
get:
@@ -8688,12 +8340,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceNamespaceCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -8719,12 +8365,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}':
get:
@@ -8770,12 +8410,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -8807,12 +8441,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -8839,12 +8467,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/microsoft.graph.importResourceActions':
post:
@@ -8887,12 +8509,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: action
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions':
get:
@@ -8950,12 +8566,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceActionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -8990,12 +8600,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}':
get:
@@ -9050,12 +8654,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -9095,12 +8693,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -9135,12 +8727,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/authenticationContext':
get:
@@ -9194,12 +8780,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.authenticationContextClassReference'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/resourceScope':
get:
@@ -9253,12 +8833,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -9298,12 +8872,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -9338,12 +8906,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/$count':
get:
@@ -9367,12 +8929,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/deviceManagement/resourceNamespaces/$count:
get:
tags:
@@ -9387,12 +8943,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/deviceManagement/roleAssignments:
get:
tags:
@@ -9444,12 +8994,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleAssignmentMultipleCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -9479,12 +9023,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}':
get:
@@ -9534,18 +9072,12 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
- roleManagement.rbacApplicationMultiple
summary: Update unifiedRoleAssignmentMultiple
- description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment does not support update."
+ description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment doesn't support update."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-update?view=graph-rest-beta
@@ -9575,12 +9107,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignmentMultiple'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -9611,12 +9137,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes':
get:
@@ -9674,12 +9194,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.appScopeCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -9714,12 +9228,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes/{appScope-id}':
get:
@@ -9774,12 +9282,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -9819,12 +9321,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -9859,12 +9355,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/appScopes/$count':
get:
@@ -9888,12 +9378,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/directoryScopes':
get:
tags:
@@ -9950,12 +9434,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -10013,12 +9491,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/directoryScopes/$count':
get:
@@ -10042,12 +9514,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/principals':
get:
tags:
@@ -10104,12 +9570,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -10167,12 +9627,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/principals/$count':
get:
@@ -10196,12 +9650,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/deviceManagement/roleAssignments/{unifiedRoleAssignmentMultiple-id}/roleDefinition':
get:
tags:
@@ -10247,12 +9695,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/deviceManagement/roleAssignments/$count:
get:
@@ -10268,12 +9710,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/deviceManagement/roleDefinitions:
get:
tags:
@@ -10321,12 +9757,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -10352,12 +9782,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleDefinitions/{unifiedRoleDefinition-id}':
get:
@@ -10403,12 +9827,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -10440,12 +9858,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -10472,12 +9884,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom':
get:
@@ -10535,12 +9941,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -10575,12 +9975,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}':
get:
@@ -10635,12 +10029,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -10680,12 +10068,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -10720,12 +10102,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/deviceManagement/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
@@ -10831,12 +10207,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -10863,12 +10233,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/deviceManagement/roleDefinitions/{unifiedRoleDefinition-id}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
tags:
@@ -10965,12 +10329,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -10989,12 +10347,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange:
get:
tags:
@@ -11031,12 +10383,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacApplication'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -11059,12 +10405,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacApplication'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -11083,12 +10423,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/exchange/customAppScopes:
get:
@@ -11141,12 +10475,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.customAppScopeCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -11176,12 +10504,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.customAppScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/customAppScopes/{customAppScope-id}':
get:
@@ -11231,12 +10553,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.customAppScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -11272,12 +10588,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.customAppScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -11308,12 +10618,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/exchange/customAppScopes/$count:
get:
@@ -11329,12 +10633,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange/resourceNamespaces:
get:
tags:
@@ -11383,12 +10681,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceNamespaceCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -11414,12 +10706,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}':
get:
@@ -11466,12 +10752,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -11503,12 +10783,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -11535,12 +10809,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/microsoft.graph.importResourceActions':
post:
@@ -11583,12 +10851,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceNamespace'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: action
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions':
get:
@@ -11646,12 +10908,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRbacResourceActionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -11686,12 +10942,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}':
get:
@@ -11746,12 +10996,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -11791,12 +11035,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceAction'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -11831,12 +11069,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/authenticationContext':
get:
@@ -11890,12 +11122,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.authenticationContextClassReference'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/{unifiedRbacResourceAction-id}/resourceScope':
get:
@@ -11949,12 +11175,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -11994,12 +11214,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRbacResourceScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -12034,12 +11248,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/resourceNamespaces/{unifiedRbacResourceNamespace-id}/resourceActions/$count':
get:
@@ -12063,12 +11271,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange/resourceNamespaces/$count:
get:
tags:
@@ -12083,12 +11285,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange/roleAssignments:
get:
tags:
@@ -12140,12 +11336,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleAssignmentCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -12175,12 +11365,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleAssignments/{unifiedRoleAssignment-id}':
get:
@@ -12230,12 +11414,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -12267,12 +11445,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -12303,12 +11475,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleAssignments/{unifiedRoleAssignment-id}/appScope':
get:
@@ -12355,12 +11521,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -12392,12 +11552,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -12424,12 +11578,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleAssignments/{unifiedRoleAssignment-id}/directoryScope':
get:
@@ -12476,12 +11624,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleAssignments/{unifiedRoleAssignment-id}/principal':
get:
@@ -12528,12 +11670,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleAssignments/{unifiedRoleAssignment-id}/roleDefinition':
get:
@@ -12580,12 +11716,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/exchange/roleAssignments/$count:
get:
@@ -12601,12 +11731,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange/roleDefinitions:
get:
tags:
@@ -12658,12 +11782,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -12689,12 +11807,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleDefinitions/{unifiedRoleDefinition-id}':
get:
@@ -12744,12 +11856,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -12781,12 +11887,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -12813,12 +11913,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom':
get:
@@ -12876,12 +11970,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleDefinitionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -12916,12 +12004,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}':
get:
@@ -12976,12 +12058,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -13021,12 +12097,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -13061,12 +12131,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/roleDefinitions/{unifiedRoleDefinition-id}/inheritsPermissionsFrom/{unifiedRoleDefinition-id1}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
@@ -13172,12 +12236,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -13204,12 +12262,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
'/roleManagement/exchange/roleDefinitions/{unifiedRoleDefinition-id}/microsoft.graph.assignedPrincipals(transitive=@transitive,directoryScopeType=''@directoryScopeType'',directoryScopeId=''@directoryScopeId'')':
get:
tags:
@@ -13306,12 +12358,6 @@ paths:
type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
@@ -13330,12 +12376,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
/roleManagement/exchange/transitiveRoleAssignments:
get:
tags:
@@ -13384,12 +12424,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.unifiedRoleAssignmentCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -13415,12 +12449,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/transitiveRoleAssignments/{unifiedRoleAssignment-id}':
get:
@@ -13467,12 +12495,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -13504,12 +12526,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleAssignment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -13536,12 +12552,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/transitiveRoleAssignments/{unifiedRoleAssignment-id}/appScope':
get:
@@ -13588,12 +12598,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
patch:
tags:
@@ -13625,12 +12629,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.appScope'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
delete:
tags:
@@ -13657,12 +12655,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/transitiveRoleAssignments/{unifiedRoleAssignment-id}/directoryScope':
get:
@@ -13709,12 +12701,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/transitiveRoleAssignments/{unifiedRoleAssignment-id}/principal':
get:
@@ -13761,12 +12747,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
'/roleManagement/exchange/transitiveRoleAssignments/{unifiedRoleAssignment-id}/roleDefinition':
get:
@@ -13813,12 +12793,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.unifiedRoleDefinition'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
x-ms-docs-operation-type: operation
/roleManagement/exchange/transitiveRoleAssignments/$count:
get:
@@ -13834,12 +12808,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-12-01'
- date: '2025-01-01'
- version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
- description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
components:
schemas:
microsoft.graph.androidDeviceOwnerEnrollmentProfile:
@@ -15323,7 +14291,7 @@ components:
properties:
displayName:
type: string
- description: Provides the display name of the app-specific resource represented by the app scope. Read only.
+ description: Provides the display name of the app-specific resource represented by the app scope. Read-only.
nullable: true
type:
type: string
@@ -15709,7 +14677,7 @@ components:
description: Indicates Mobile Application Management (MAM) for iOS devices
name: iOSMobileApplicationManagement
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Evolvable enumeration sentinel value. Do not use
name: unknownFutureValue
- value: windowsMobileApplicationManagement
description: Indicates Mobile Application Management (MAM) for Windows devices.
diff --git a/openApiDocs/beta/DeviceManagement.yml b/openApiDocs/beta/DeviceManagement.yml
index 70eb28ccff..b0909b1acd 100644
--- a/openApiDocs/beta/DeviceManagement.yml
+++ b/openApiDocs/beta/DeviceManagement.yml
@@ -41682,7 +41682,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Singleton that acts as container for a collection of Resource Access entities.
microsoft.graph.advancedThreatProtectionOnboardingStateSummary:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -42104,7 +42103,7 @@ components:
description: Indicates Mobile Application Management (MAM) for iOS devices
name: iOSMobileApplicationManagement
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Evolvable enumeration sentinel value. Do not use
name: unknownFutureValue
- value: windowsMobileApplicationManagement
description: Indicates Mobile Application Management (MAM) for Windows devices.
@@ -44586,6 +44585,13 @@ components:
description: Json of the rules.
format: base64url
nullable: true
+ runIntervalInMinutes:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Indicates the interval, in minutes, at which the custom compliance script is evaluated on the device. Allowed range from 1 to 480. Nullable.'
+ format: int32
+ nullable: true
additionalProperties:
type: object
microsoft.graph.deviceComplianceScriptValidationResult:
@@ -51397,6 +51403,7 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ description: Singleton entity that acts as a container for all reports functionality.
microsoft.graph.resourceOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -55938,7 +55945,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -55965,7 +55972,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -56130,7 +56137,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -56152,7 +56159,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -56187,7 +56194,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -56291,7 +56298,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -56424,6 +56431,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -58755,7 +58768,7 @@ components:
description: Indicated atleast 1 tenant admin & system ingested definitions configured for this policy
name: mixed
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Unknown future enum value
name: unknownFutureValue
microsoft.graph.groupPolicyConfigurationType:
title: groupPolicyConfigurationType
@@ -59475,7 +59488,7 @@ components:
description: Indicates that the log collection has failed
name: failed
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Placeholder value for future expansion enums
name: unknownFutureValue
microsoft.graph.microsoftTunnelDeploymentMode:
title: microsoftTunnelDeploymentMode
@@ -59545,7 +59558,7 @@ components:
description: 'Indicates the failure of the upgrade during the upgrade cycle of when Intune begins upgrading servers, one server at a time'
name: upgradeFailed
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Evolvable enumeration sentinel value. Do not use enums.
name: unknownFutureValue
microsoft.graph.mobileAppTroubleshootingHistoryItem:
title: mobileAppTroubleshootingHistoryItem
@@ -62162,7 +62175,7 @@ components:
description: Offboarding
name: offboarding
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: UnknownFutureValue
name: unknownFutureValue
microsoft.graph.cloudCertificationAuthorityCertificateKeySize:
title: cloudCertificationAuthorityCertificateKeySize
@@ -63381,7 +63394,7 @@ components:
description: Indicates the category is ingested through system ingestion process
name: builtIn
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Unknown future enum value
name: unknownFutureValue
microsoft.graph.groupPolicyMigrationReadiness:
title: groupPolicyMigrationReadiness
@@ -64479,7 +64492,7 @@ components:
description: Tenant has enabled the connection
name: enabled
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Future authentication method to be added here.
name: unknownFutureValue
microsoft.graph.deviceManagementSettingInsightsDefinition:
title: deviceManagementSettingInsightsDefinition
@@ -65429,6 +65442,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -66020,6 +66035,8 @@ components:
type: string
nullable: true
description: The list of scope tag IDs for this resource. Read-only.
+ snapshotResetMode:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcSnapshotResetMode'
userExperienceType:
$ref: '#/components/schemas/microsoft.graph.cloudPcUserExperienceType'
userSettingsPersistenceConfiguration:
@@ -69244,6 +69261,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -69319,7 +69370,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -69528,7 +69578,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -69895,7 +69945,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -70654,7 +70703,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -70704,6 +70752,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -73208,6 +73261,7 @@ components:
iconPath:
type: string
description: 'Specifies the path to the icon file for the application within the OS of the hosting Cloud PC. When an admin updates the path of a cloud app, the value should be a rooted absolute path. For example, C:/Windows/system32/WindowsPowerShell/v1.0/powershell_ise.exe. If this property isn''t defined, a default icon is used.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.cloudPcCloudAppStatus:
@@ -73458,6 +73512,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcUserAccountType:
title: cloudPcUserAccountType
@@ -73766,6 +73822,14 @@ components:
$ref: '#/components/schemas/microsoft.graph.microsoftManagedDesktopType'
additionalProperties:
type: object
+ microsoft.graph.cloudPcSnapshotResetMode:
+ title: cloudPcSnapshotResetMode
+ enum:
+ - notApplicable
+ - enabled
+ - disabled
+ - unknownFutureValue
+ type: string
microsoft.graph.cloudPcUserSettingsPersistenceConfiguration:
title: cloudPcUserSettingsPersistenceConfiguration
type: object
@@ -74430,6 +74494,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -76110,7 +76177,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -76126,13 +76193,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -76262,7 +76329,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -76548,6 +76615,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -76717,6 +76828,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -77096,7 +77209,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -77110,6 +77223,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -77632,6 +77749,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -77994,7 +78112,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -78146,7 +78264,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -78980,6 +79098,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -79341,6 +79461,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -79429,6 +79565,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -79678,6 +79819,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -81064,6 +81210,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -81363,7 +81512,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -82372,6 +82521,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -82621,8 +82779,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -82712,6 +82868,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -83102,6 +83283,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -83120,7 +83313,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -85295,12 +85487,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -85334,6 +85529,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -85626,22 +85831,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -85957,6 +86146,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -86595,7 +86807,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -86981,6 +87193,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -88329,6 +88542,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -88529,28 +88744,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -88569,6 +88762,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -90060,6 +90261,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -92398,6 +92615,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -92456,14 +92681,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -93397,16 +93614,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -93425,20 +93645,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -93457,16 +93681,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -93485,16 +93712,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -93515,10 +93745,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -93715,6 +93947,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -93729,6 +93964,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -94174,6 +94416,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -94184,10 +94427,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -94198,6 +94443,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -94208,6 +94454,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -94216,10 +94463,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Devices.CloudPrint.yml b/openApiDocs/beta/Devices.CloudPrint.yml
index 65969999bb..f21fe06341 100644
--- a/openApiDocs/beta/Devices.CloudPrint.yml
+++ b/openApiDocs/beta/Devices.CloudPrint.yml
@@ -10160,7 +10160,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -10527,7 +10527,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.user:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
@@ -10540,7 +10539,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -10567,7 +10566,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -10732,7 +10731,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -10754,7 +10753,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -10789,7 +10788,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -10893,7 +10892,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -11026,6 +11025,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -11734,6 +11739,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -13940,6 +13946,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -14571,6 +14579,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -14592,7 +14634,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -15686,7 +15727,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -15725,6 +15765,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -17235,6 +17280,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -17765,6 +17813,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -18168,6 +18218,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -18334,7 +18389,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -18348,6 +18403,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -18829,7 +18888,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -19059,7 +19118,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -20482,7 +20541,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -20498,13 +20557,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -20596,7 +20655,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -20914,6 +20973,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -21343,6 +21404,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23776,6 +23881,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -24225,6 +24332,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -25528,6 +25640,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -25995,8 +26110,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -26086,6 +26199,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -26476,6 +26614,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -26494,7 +26644,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -26814,6 +26963,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.siteArchivalDetails:
title: siteArchivalDetails
type: object
@@ -28214,7 +28386,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -29048,6 +29220,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -30735,12 +30916,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -30774,6 +30958,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -31895,7 +32089,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -32281,6 +32475,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -32649,28 +32844,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -32689,6 +32862,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -33228,6 +33409,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.siteArchiveStatus:
title: siteArchiveStatus
enum:
@@ -34380,6 +34577,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -35794,14 +35993,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -36777,6 +36968,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -37524,16 +37723,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -37552,20 +37754,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -37584,16 +37790,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -37612,16 +37821,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -37642,10 +37854,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -37826,6 +38040,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -37840,6 +38057,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -38089,6 +38313,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -38099,10 +38324,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -38113,6 +38340,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -38123,6 +38351,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -38131,10 +38360,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Devices.CorporateManagement.yml b/openApiDocs/beta/Devices.CorporateManagement.yml
index da9f4bbcaa..b9f23a1333 100644
--- a/openApiDocs/beta/Devices.CorporateManagement.yml
+++ b/openApiDocs/beta/Devices.CorporateManagement.yml
@@ -56571,6 +56571,8 @@ components:
- title: iosStoreApp
type: object
properties:
+ appleDeviceAppDeliveryProtocolType:
+ $ref: '#/components/schemas/microsoft.graph.appleDeviceDeliveryProtocol'
applicableDeviceType:
$ref: '#/components/schemas/microsoft.graph.iosDeviceType'
appStoreUrl:
@@ -56592,6 +56594,8 @@ components:
- title: iosVppApp
type: object
properties:
+ appleDeviceAppDeliveryProtocolType:
+ $ref: '#/components/schemas/microsoft.graph.appleDeviceDeliveryProtocol'
applicableDeviceType:
$ref: '#/components/schemas/microsoft.graph.iosDeviceType'
appStoreUrl:
@@ -59950,6 +59954,8 @@ components:
description: Indicates whether printing is allowed from managed apps.
protectedMessagingRedirectAppType:
$ref: '#/components/schemas/microsoft.graph.messagingRedirectAppType'
+ purviewContentEvaluationRequired:
+ $ref: '#/components/schemas/microsoft.graph.managedAppPurviewEvaluationRequirement'
saveAsBlocked:
type: boolean
description: Indicates whether users may use the 'Save As' menu item to save a copy of protected files.
@@ -60923,6 +60929,8 @@ components:
properties:
deviceRestartBehavior:
$ref: '#/components/schemas/microsoft.graph.win32LobAppRestartBehavior'
+ inUseBehavior:
+ $ref: '#/components/schemas/microsoft.graph.win32LobAppInUseActionType'
maxRunTimeInMinutes:
maximum: 2147483647
minimum: -2147483648
@@ -63006,7 +63014,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -63033,7 +63041,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -63198,7 +63206,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -63220,7 +63228,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -63255,7 +63263,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -63359,7 +63367,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -63492,6 +63500,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -66278,6 +66292,31 @@ components:
- value: blocked
description: App protection policy will block messaging redirection to any app.
name: blocked
+ microsoft.graph.managedAppPurviewEvaluationRequirement:
+ title: managedAppPurviewEvaluationRequirement
+ enum:
+ - notRequired
+ - requiredWhenOnline
+ - required
+ - unknownFutureValue
+ type: string
+ description: Specifies whether Microsoft Purview Data Loss Prevention (DLP) content evaluation is required before data sharing.
+ x-ms-enum:
+ name: managedAppPurviewEvaluationRequirement
+ modelAsString: false
+ values:
+ - value: notRequired
+ description: Microsoft Purview Data Loss Prevention (DLP) content evaluation is not required.
+ name: notRequired
+ - value: requiredWhenOnline
+ description: Microsoft Purview Data Loss Prevention (DLP) content evaluation is required when online; sharing is allowed if the service is unreachable.
+ name: requiredWhenOnline
+ - value: required
+ description: Microsoft Purview Data Loss Prevention (DLP) content evaluation is always required; sharing is blocked if the service is unreachable.
+ name: required
+ - value: unknownFutureValue
+ description: Evolvable enumeration sentinel value. Do not use.
+ name: unknownFutureValue
microsoft.graph.managedAppLogUploadState:
title: managedAppLogUploadState
enum:
@@ -66507,6 +66546,35 @@ components:
- value: force
description: Intune will force the device to restart immediately after the app installation operation.
name: force
+ microsoft.graph.win32LobAppInUseActionType:
+ title: win32LobAppInUseActionType
+ enum:
+ - notEnabled
+ - fail
+ - terminateWithoutUserInteraction
+ - terminateWithUserInteraction
+ - unknownFutureValue
+ type: string
+ description: 'Indicates whether app-in-use detection is enabled before app enforcement, and if enabled, the action to take when the app is detected to be in-use.'
+ x-ms-enum:
+ name: win32LobAppInUseActionType
+ modelAsString: false
+ values:
+ - value: notEnabled
+ description: Default. Indicates that no in-use detection will be evaluated before an app enforcement.
+ name: notEnabled
+ - value: fail
+ description: 'Indicates that the in-use detection will occur immediately before app enforcement. Enforcement will not occur if the app is detected to be in-use, and an error status will be reported for the app.'
+ name: fail
+ - value: terminateWithoutUserInteraction
+ description: 'Indicates that in-use detection will occur immediately before app enforcement. If the app is detected to be in-use, the processes specified in the corresponding process detection rules will be terminated, and app enforcement will commence.'
+ name: terminateWithoutUserInteraction
+ - value: terminateWithUserInteraction
+ description: 'Indicates that in-use detection will occur immediately before app enforcement. If the app is detected to be in-use, the end user will be prompted according to the configured deferral and countdown settings, and the processes specified in the corresponding process detection rules will be terminated before app enforcement is commenced. If any of the processes cannot be terminated, the app will not be enforced, and an error status will be reported for the app.'
+ name: terminateWithUserInteraction
+ - value: unknownFutureValue
+ description: Evolvable enumeration sentinel value. Do not use.
+ name: unknownFutureValue
microsoft.graph.runAsAccountType:
title: runAsAccountType
enum:
@@ -68760,6 +68828,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -69309,6 +69379,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -69384,7 +69488,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -69593,7 +69696,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -69960,7 +70063,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -70560,7 +70662,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -70610,6 +70711,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -71355,6 +71461,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -73047,7 +73156,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -73063,13 +73172,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -73199,7 +73308,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -73481,6 +73590,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcUserAccountType:
title: cloudPcUserAccountType
@@ -73751,6 +73862,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -73920,6 +74075,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -74299,7 +74456,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -74313,6 +74470,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -74835,6 +74996,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -75197,7 +75359,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -75349,7 +75511,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -76020,6 +76182,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -76381,6 +76545,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -76469,6 +76649,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -76718,6 +76903,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -77835,6 +78025,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -78134,7 +78327,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -79217,6 +79410,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -79466,8 +79668,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -79557,6 +79757,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -79947,6 +80172,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -79965,7 +80202,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -82012,12 +82248,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -82051,6 +82290,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -82343,22 +82592,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -82674,6 +82907,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -83312,7 +83568,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -83698,6 +83954,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -84972,6 +85229,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -85172,28 +85431,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -85212,6 +85449,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -86703,6 +86948,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -89041,6 +89302,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -89099,14 +89368,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -90040,16 +90301,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -90068,20 +90332,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -90100,16 +90368,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -90128,16 +90399,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -90158,10 +90432,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -90358,6 +90634,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -90372,6 +90651,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -90817,6 +91103,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -90827,10 +91114,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -90841,6 +91130,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -90851,6 +91141,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -90859,10 +91150,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Devices.ServiceAnnouncement.yml b/openApiDocs/beta/Devices.ServiceAnnouncement.yml
index 22dbb6f7e1..229100d393 100644
--- a/openApiDocs/beta/Devices.ServiceAnnouncement.yml
+++ b/openApiDocs/beta/Devices.ServiceAnnouncement.yml
@@ -490,7 +490,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Invoke function incidentReport
- description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
+ description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document doesn't exist for the issue.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-incidentreport?view=graph-rest-beta
@@ -647,7 +647,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Get serviceHealthIssue
- description: Retrieve the properties and relationships of a serviceHealthIssue object. This operation retrieves a specified service health issue for tenant. The operation returns an error if the issue does not exist for the tenant.
+ description: Retrieve the properties and relationships of a serviceHealthIssue object. This operation retrieves a specified service health issue for tenant. The operation returns an error if the issue doesn't exist for the tenant.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-get?view=graph-rest-beta
@@ -753,7 +753,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Invoke function incidentReport
- description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
+ description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document doesn't exist for the issue.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-incidentreport?view=graph-rest-beta
@@ -880,7 +880,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Get serviceUpdateMessage
- description: Retrieve the properties and relationships of a serviceUpdateMessage object. This operation retrieves a specified service update message for the tenant. The operation returns an error if the message does not exist for the tenant.
+ description: Retrieve the properties and relationships of a serviceUpdateMessage object. This operation retrieves a specified service update message for the tenant. The operation returns an error if the message doesn't exist for the tenant.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/serviceupdatemessage-get?view=graph-rest-beta
@@ -2146,19 +2146,19 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceHealth'
- description: 'A collection of service health information for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service health information for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
issues:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceHealthIssue'
- description: 'A collection of service issues for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service issues for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
messages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
- description: 'A collection of service messages for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service messages for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
additionalProperties:
type: object
diff --git a/openApiDocs/beta/Education.yml b/openApiDocs/beta/Education.yml
index 9bab6c871b..9e542b6103 100644
--- a/openApiDocs/beta/Education.yml
+++ b/openApiDocs/beta/Education.yml
@@ -124,7 +124,7 @@ paths:
tags:
- education.educationClass
summary: Create educationClass
- description: "Create a new class. This will also create a universal group. When you use this API to create a class, it will add special properties to the group, which will\r\nadd features such as assignments and special handling within Microsoft Teams when teams are created using the group. Please note that this API only creates the universal group and does not create a team. Microsoft Teams provides a user interface for teachers to create teams for their own classes using the groups created by this API."
+ description: "Create a new class. This will also create a universal group. When you use this API to create a class, it will add special properties to the group, which will\r\nadd features such as assignments and special handling within Microsoft Teams when teams are created using the group. Please note that this API only creates the universal group and doesn't create a team. Microsoft Teams provides a user interface for teachers to create teams for their own classes using the groups created by this API."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/educationroot-post-classes?view=graph-rest-beta
@@ -19127,7 +19127,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -19494,7 +19494,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.educationModule:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -19788,7 +19787,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -19815,7 +19814,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -19980,7 +19979,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -20002,7 +20001,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -20037,7 +20036,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -20141,7 +20140,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -20274,6 +20273,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -21151,6 +21156,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -23505,6 +23511,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -24136,6 +24144,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -24157,7 +24199,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -25251,7 +25292,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -25290,6 +25330,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -26354,6 +26399,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -26885,6 +26933,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -27288,6 +27338,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -27454,7 +27509,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -27468,6 +27523,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -27949,7 +28008,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -28179,7 +28238,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -29662,7 +29721,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -29678,13 +29737,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -29776,7 +29835,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -30094,6 +30153,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -30491,6 +30552,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -32924,6 +33029,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -33285,6 +33392,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -33373,6 +33496,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -34706,6 +34834,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -35167,8 +35298,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -35258,6 +35387,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -35648,6 +35802,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -35666,7 +35832,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -35986,6 +36151,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.siteArchivalDetails:
title: siteArchivalDetails
type: object
@@ -37486,7 +37674,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -38312,6 +38500,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -39999,12 +40196,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -40038,6 +40238,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -40330,22 +40540,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -41175,7 +41369,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -41561,6 +41755,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -41949,28 +42144,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -41989,6 +42162,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -42528,6 +42709,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.siteArchiveStatus:
title: siteArchiveStatus
enum:
@@ -44203,6 +44400,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -45617,14 +45816,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -47873,6 +48064,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -48780,16 +48979,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -48808,20 +49010,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -48840,16 +49046,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -48868,16 +49077,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -48898,10 +49110,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -49082,6 +49296,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -49096,6 +49313,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -49354,6 +49578,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -49364,10 +49589,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -49378,6 +49605,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -49388,6 +49616,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -49396,10 +49625,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Files.yml b/openApiDocs/beta/Files.yml
index 344e76fe78..52b742f842 100644
--- a/openApiDocs/beta/Files.yml
+++ b/openApiDocs/beta/Files.yml
@@ -100120,6 +100120,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -100267,7 +100269,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -100294,7 +100296,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -100459,7 +100461,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -100481,7 +100483,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -100516,7 +100518,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -100620,7 +100622,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -100753,6 +100755,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -101421,6 +101429,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -101439,7 +101459,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -101572,7 +101591,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -101586,6 +101605,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -102214,8 +102237,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -102305,6 +102326,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -104221,6 +104267,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -104852,6 +104900,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -104873,7 +104955,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -104940,7 +105021,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -105307,7 +105388,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -106527,7 +106607,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -106577,6 +106656,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -108508,28 +108592,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -108548,6 +108610,30 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.pendingContentUpdate:
title: pendingContentUpdate
type: object
@@ -108883,6 +108969,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -110441,7 +110530,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -110457,13 +110546,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -110593,7 +110682,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -110911,6 +111000,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -111340,6 +111431,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -111612,6 +111747,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -111974,7 +112110,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -112126,7 +112262,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -114667,6 +114803,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -115116,6 +115254,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -115365,6 +115508,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -116882,30 +117030,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError'
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.defaultSharingLink:
title: defaultSharingLink
type: object
@@ -117215,6 +117339,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -117479,7 +117606,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -118608,6 +118735,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -120935,12 +121071,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -120974,6 +121113,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -121581,6 +121730,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -122219,7 +122391,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -122605,6 +122777,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -124417,6 +124590,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -125655,6 +125830,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -128275,6 +128466,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -128937,16 +129136,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -128965,20 +129167,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -128997,16 +129203,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -129025,16 +129234,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -129055,10 +129267,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -129255,6 +129469,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -129269,6 +129486,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -129379,6 +129603,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -129389,10 +129614,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -129403,6 +129630,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -129413,6 +129641,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -129421,10 +129650,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Groups.yml b/openApiDocs/beta/Groups.yml
index 8e274833fe..d1288232a5 100644
--- a/openApiDocs/beta/Groups.yml
+++ b/openApiDocs/beta/Groups.yml
@@ -549,7 +549,7 @@ paths:
tags:
- groups.directoryObject
summary: List acceptedSenders
- description: 'Get a list of users or groups that are in the accepted-senders list for this group. Users in the accepted senders list can post to conversations of the group (identified in the GET request URL). Make sure you do not specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error.'
+ description: 'Get a list of users or groups that are in the accepted-senders list for this group. Users in the accepted senders list can post to conversations of the group (identified in the GET request URL). Make sure you don''t specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-list-acceptedsenders?view=graph-rest-beta
@@ -673,7 +673,7 @@ paths:
tags:
- groups.directoryObject
summary: List acceptedSenders
- description: 'Get a list of users or groups that are in the accepted-senders list for this group. Users in the accepted senders list can post to conversations of the group (identified in the GET request URL). Make sure you do not specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error.'
+ description: 'Get a list of users or groups that are in the accepted-senders list for this group. Users in the accepted senders list can post to conversations of the group (identified in the GET request URL). Make sure you don''t specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-list-acceptedsenders?view=graph-rest-beta
@@ -10844,7 +10844,7 @@ paths:
tags:
- groups.directorySetting
summary: Create settings
- description: 'Create a new directory setting based on the templates available in directorySettingTemplates. These settings can be at the tenant-level or at the group level. Group settings apply to only Microsoft 365 groups. The template named Group.Unified can be used to configure tenant-wide Microsoft 365 group settings, while the template named Group.Unified.Guest can be used to configure group-specific settings.'
+ description: 'Create a new directory setting based on the templates available in directorySettingTemplates. These settings can be at the tenant-level or at the group level. The following setting templates are available for groups:'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-post-settings?view=graph-rest-beta
@@ -16454,7 +16454,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -16821,7 +16821,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.conversation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -18021,7 +18020,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -18048,7 +18047,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -18213,7 +18212,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -18235,7 +18234,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -18270,7 +18269,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -18374,7 +18373,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -18507,6 +18506,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -19036,6 +19041,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -20464,6 +20470,8 @@ components:
type: boolean
description: Locks the keyCredentials and passwordCredentials properties for modification where credential usage type is Verify. This locks OAuth service principals.
nullable: true
+ enforcementScope:
+ $ref: '#/components/schemas/microsoft.graph.servicePrincipalLockScope'
isEnabled:
type: boolean
description: 'Enables or disables service principal lock configuration. To allow the sensitive properties to be updated, update this property to false to disable the lock on the service principal.'
@@ -21933,6 +21941,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -22340,6 +22350,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -22361,7 +22405,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23394,7 +23437,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23433,6 +23475,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -24214,7 +24261,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -24228,6 +24275,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -24570,6 +24621,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -24973,6 +25027,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -25376,6 +25432,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -25841,7 +25902,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -26071,7 +26132,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -26425,6 +26486,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.servicePrincipalLockScope:
+ title: servicePrincipalLockScope
+ enum:
+ - notConfigured
+ - foreignTenantOnly
+ - everywhere
+ - unknownFutureValue
+ type: string
microsoft.graph.kind:
title: kind
enum:
@@ -26694,7 +26763,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -27655,7 +27724,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -27671,13 +27740,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -27769,7 +27838,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -28087,6 +28156,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -28405,6 +28476,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -30774,6 +30889,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -31135,6 +31252,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -31223,6 +31356,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -32811,6 +32949,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -33236,8 +33377,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -33327,6 +33466,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -33717,6 +33881,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -33735,7 +33911,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -34055,6 +34230,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.siteArchivalDetails:
title: siteArchivalDetails
type: object
@@ -36066,6 +36264,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -37760,12 +37967,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -37799,6 +38009,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -38091,22 +38311,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -38936,7 +39140,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -39322,6 +39526,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -39773,28 +39978,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -39813,6 +39996,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -40352,6 +40543,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.siteArchiveStatus:
title: siteArchiveStatus
enum:
@@ -42053,6 +42260,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -43499,14 +43708,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -44095,16 +44296,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -44123,20 +44327,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -44155,16 +44363,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -44183,16 +44394,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -44213,10 +44427,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -45739,6 +45955,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -46404,6 +46628,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -46414,10 +46639,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -46428,6 +46655,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -46438,6 +46666,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -46446,10 +46675,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
@@ -46759,6 +46990,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -46773,6 +47007,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/Identity.DirectoryManagement.yml b/openApiDocs/beta/Identity.DirectoryManagement.yml
index e17ccc1665..29148ef3e8 100644
--- a/openApiDocs/beta/Identity.DirectoryManagement.yml
+++ b/openApiDocs/beta/Identity.DirectoryManagement.yml
@@ -132,7 +132,7 @@ paths:
tags:
- admin.peopleAdminSettings
summary: Update insightsSettings
- description: "Update privacy settings to display or return the specified type of insights in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
+ description: "Update privacy settings to display or return the specified type of insightsSettings in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/insightssettings-update?view=graph-rest-beta
@@ -556,7 +556,7 @@ paths:
tags:
- admin.peopleAdminSettings
summary: List profilePropertySettings
- description: Get a collection of profilePropertySetting objects that define the configuration for user profile properties in an organization. The id property identifies each resource object uniquely.
+ description: Get a collection of profilePropertySetting objects that define the configuration for user profile property settings in an organization. The id property identifies each resource object uniquely.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/peopleadminsettings-list-profilepropertysettings?view=graph-rest-beta
@@ -720,7 +720,7 @@ paths:
tags:
- admin.peopleAdminSettings
summary: Delete profilePropertySetting
- description: Delete a profilePropertySetting object.
+ description: 'Delete a profilePropertySetting object. You shouldn''t delete a profilePropertySetting that includes a source precedence configuration. Instead, patch it to a default state that contains only the Microsoft Entra ID source reference. This delete operation is supported but fails unless the prioritizedSourceUrls property contains only the Entra ID source reference.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/profilepropertysetting-delete?view=graph-rest-beta
@@ -33997,7 +33997,7 @@ paths:
tags:
- organization.organizationSettings
summary: Update insightsSettings
- description: "Update privacy settings to display or return the specified type of insights in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
+ description: "Update privacy settings to display or return the specified type of insightsSettings in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/insightssettings-update?view=graph-rest-beta
@@ -34341,7 +34341,7 @@ paths:
tags:
- organization.organizationSettings
summary: Update insightsSettings
- description: "Update privacy settings to display or return the specified type of insights in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
+ description: "Update privacy settings to display or return the specified type of insightsSettings in an organization. The type of settings can be contact insights, item insights, or people insights. To learn more about customizing insights privacy for your organization, see:\r\n- Customize item insights privacy \r\n- Customize people insights privacy"
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/insightssettings-update?view=graph-rest-beta
@@ -34600,7 +34600,7 @@ paths:
tags:
- settings.directorySetting
summary: Create settings
- description: 'Create a new directory setting based on the templates available in directorySettingTemplates. These settings can be at the tenant-level or at the group level. Group settings apply to only Microsoft 365 groups. The template named Group.Unified can be used to configure tenant-wide Microsoft 365 group settings, while the template named Group.Unified.Guest can be used to configure group-specific settings.'
+ description: 'Create a new directory setting based on the templates available in directorySettingTemplates. These settings can be at the tenant-level or at the group level. The following setting templates are available for groups:'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-post-settings?view=graph-rest-beta
@@ -35326,7 +35326,7 @@ components:
properties:
displayName:
type: string
- description: Name of the property-level setting.
+ description: Name of the property associated with this setting.
nullable: true
name:
type: string
@@ -35337,7 +35337,7 @@ components:
items:
type: string
nullable: true
- description: A collection of prioritized profile source URLs ordered by data precedence within an organization.
+ description: 'A collection of prioritized profile source URLs ordered by data precedence within an organization. For details, see Manage profile source precedence in Microsoft 365.'
additionalProperties:
type: object
microsoft.graph.profileSource:
@@ -35896,7 +35896,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -36263,7 +36263,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.orgContact:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
@@ -36661,7 +36660,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -36688,7 +36687,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -36853,7 +36852,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -36875,7 +36874,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -36910,7 +36909,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -37014,7 +37013,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -37147,6 +37146,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -38712,6 +38717,10 @@ components:
type: string
description: The date and time when the related tenant was discovered. The timestamp type represents date and time information using ISO 8601 format and is always in UTC.
format: date-time
+ isMicrosoftInfrastructure:
+ type: boolean
+ description: Indicates whether this tenant is a Microsoft infrastructure tenant.
+ readOnly: true
appB2BSignInActivityMetrics:
$ref: '#/components/schemas/microsoft.graph.tenantGovernanceServices.b2BSignInActivityMetrics'
b2BRegistrationMetrics:
@@ -38817,7 +38826,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -39930,6 +39939,8 @@ components:
type: boolean
description: Locks the keyCredentials and passwordCredentials properties for modification where credential usage type is Verify. This locks OAuth service principals.
nullable: true
+ enforcementScope:
+ $ref: '#/components/schemas/microsoft.graph.servicePrincipalLockScope'
isEnabled:
type: boolean
description: 'Enables or disables service principal lock configuration. To allow the sensitive properties to be updated, update this property to false to disable the lock on the service principal.'
@@ -40269,6 +40280,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -42289,6 +42301,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -42696,6 +42710,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -42717,7 +42765,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -43750,7 +43797,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -43789,6 +43835,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -44611,6 +44662,7 @@ components:
properties:
allowOnPremUpdateOfOnPremisesObjectIdentifierEnabled:
type: boolean
+ description: 'When true, allows clients to update the onPremisesObjectIdentifier property for on-premises Active Directory synced objects.'
nullable: true
blockCloudObjectTakeoverThroughHardMatchEnabled:
type: boolean
@@ -44870,6 +44922,10 @@ components:
title: delegatedAdministrationRoleAssignment
type: object
properties:
+ groupDisplayName:
+ type: string
+ description: The display name of the security group referenced by the group navigation property. Server-populated and read-only; returns null if the referenced group has been deleted.
+ nullable: true
roleTemplates:
type: array
items:
@@ -46619,6 +46675,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.servicePrincipalLockScope:
+ title: servicePrincipalLockScope
+ enum:
+ - notConfigured
+ - foreignTenantOnly
+ - everywhere
+ - unknownFutureValue
+ type: string
microsoft.graph.kind:
title: kind
enum:
@@ -46854,6 +46918,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -47397,6 +47464,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -47800,6 +47869,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -47952,7 +48026,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -47966,6 +48040,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -48447,7 +48525,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -48677,7 +48755,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -48947,7 +49025,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -49793,7 +49871,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -49809,13 +49887,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -49907,7 +49985,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -50225,6 +50303,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -50543,6 +50623,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -52952,6 +53076,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -53313,6 +53439,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -53401,6 +53543,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -54929,6 +55076,10 @@ components:
title: delegatedAdministrationRoleAssignmentSnapshot
type: object
properties:
+ groupDisplayName:
+ type: string
+ description: The display name of the security group identified by groupId at the time the snapshot was created. Read-only.
+ nullable: true
groupId:
type: string
description: The object ID of the role-assignable security group in the governing tenant that will be assigned the specified roles.
@@ -55412,6 +55563,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -55879,8 +56033,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -55970,6 +56122,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -56360,6 +56537,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -56378,7 +56567,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -56698,6 +56886,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.siteArchivalDetails:
title: siteArchivalDetails
type: object
@@ -58784,6 +58995,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -60471,12 +60691,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -60510,6 +60733,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -60802,22 +61035,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -61647,7 +61864,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -62033,6 +62250,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -62788,28 +63006,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -62828,6 +63024,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -63367,6 +63571,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.siteArchiveStatus:
title: siteArchiveStatus
enum:
@@ -64807,6 +65027,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -66301,16 +66523,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -66329,20 +66554,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -66361,16 +66590,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -66389,16 +66621,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -66419,10 +66654,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -66613,14 +66850,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -68518,6 +68747,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -68772,6 +69009,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -68782,10 +69020,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -68796,6 +69036,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -68806,6 +69047,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -68814,10 +69056,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
@@ -69538,6 +69782,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -69552,6 +69799,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/Identity.SignIns.yml b/openApiDocs/beta/Identity.SignIns.yml
index d9dcf6f61a..3bae4bc796 100644
--- a/openApiDocs/beta/Identity.SignIns.yml
+++ b/openApiDocs/beta/Identity.SignIns.yml
@@ -7917,7 +7917,7 @@ paths:
tags:
- identity.conditionalAccessRoot
summary: Invoke function usage
- description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that do not require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
+ description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that don''t require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/authenticationstrengthpolicy-usage?view=graph-rest-beta
@@ -8900,7 +8900,7 @@ paths:
tags:
- identity.conditionalAccessRoot
summary: Invoke function usage
- description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that do not require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
+ description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that don''t require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/authenticationstrengthpolicy-usage?view=graph-rest-beta
@@ -14917,7 +14917,7 @@ paths:
tags:
- informationProtection.bitlocker
summary: List recoveryKeys
- description: 'Get a list of the bitlockerRecoveryKey objects and their properties. This operation does not return the key property. For information about how to read the key property, see Get bitlockerRecoveryKey. You can use this API to programmatically iterate through the list of recovery keys in the tenant and identify devices with BitLocker enabled. For more information, see the sample PowerShell code in BitLocker recovery process.'
+ description: 'Get a list of the bitlockerRecoveryKey objects and their properties. This operation doesn''t return the key property. For information about how to read the key property, see Get bitlockerRecoveryKey. You can use this API to programmatically iterate through the list of recovery keys in the tenant and identify devices with BitLocker enabled. For more information, see the sample PowerShell code in BitLocker recovery process.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/bitlocker-list-recoverykeys?view=graph-rest-beta
@@ -14972,7 +14972,7 @@ paths:
tags:
- informationProtection.bitlocker
summary: Get bitlockerRecoveryKey
- description: 'Retrieve the properties and relationships of a bitlockerRecoveryKey object. By default, this operation does not return the key property that represents the actual recovery key. To include the key property in the response, use the $select OData query parameter. Including the $select query parameter triggers a Microsoft Entra audit of the operation and generates an audit log. You can find the log in Microsoft Entra audit logs under the KeyManagement category.'
+ description: 'Retrieve the properties and relationships of a bitlockerRecoveryKey object. By default, this operation doesn''t return the key property that represents the actual recovery key. To include the key property in the response, use the $select OData query parameter. Including the $select query parameter triggers a Microsoft Entra audit of the operation and generates an audit log. You can find the log in Microsoft Entra audit logs under the KeyManagement category.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/bitlockerrecoverykey-get?view=graph-rest-beta
@@ -19876,7 +19876,7 @@ paths:
tags:
- policies.authenticationStrengthPolicy
summary: Invoke function usage
- description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that do not require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
+ description: 'The usage function allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that don''t require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/authenticationstrengthpolicy-usage?view=graph-rest-beta
@@ -22428,6 +22428,133 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ '/policies/crossTenantAccessPolicy/partners/{crossTenantAccessPolicyConfigurationPartner-tenantId}/serviceProviderConstraints':
+ get:
+ tags:
+ - policies.crossTenantAccessPolicy
+ summary: Get serviceProviderConstraints from policies
+ operationId: policy.crossTenantAccessPolicy.partner_GetServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - policies.crossTenantAccessPolicy
+ summary: Update the navigation property serviceProviderConstraints in policies
+ operationId: policy.crossTenantAccessPolicy.partner_UpdateServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - policies.crossTenantAccessPolicy
+ summary: Delete navigation property serviceProviderConstraints for policies
+ operationId: policy.crossTenantAccessPolicy.partner_DeleteServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/policies/crossTenantAccessPolicy/partners/{crossTenantAccessPolicyConfigurationPartner-tenantId}/serviceProviderConstraints/microsoft.graph.restore':
+ post:
+ tags:
+ - policies.crossTenantAccessPolicy
+ summary: Invoke action restore
+ operationId: policy.crossTenantAccessPolicy.partner.serviceProviderConstraint_restore
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
/policies/crossTenantAccessPolicy/partners/$count:
get:
tags:
@@ -23473,6 +23600,133 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ '/policies/deletedItems/crossTenantPartners/{crossTenantAccessPolicyConfigurationPartner-tenantId}/serviceProviderConstraints':
+ get:
+ tags:
+ - policies.policyDeletableRoot
+ summary: Get serviceProviderConstraints from policies
+ operationId: policy.deletedItem.crossTenantPartner_GetServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - policies.policyDeletableRoot
+ summary: Update the navigation property serviceProviderConstraints in policies
+ operationId: policy.deletedItem.crossTenantPartner_UpdateServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - policies.policyDeletableRoot
+ summary: Delete navigation property serviceProviderConstraints for policies
+ operationId: policy.deletedItem.crossTenantPartner_DeleteServiceProviderConstraint
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/policies/deletedItems/crossTenantPartners/{crossTenantAccessPolicyConfigurationPartner-tenantId}/serviceProviderConstraints/microsoft.graph.restore':
+ post:
+ tags:
+ - policies.policyDeletableRoot
+ summary: Invoke action restore
+ operationId: policy.deletedItem.crossTenantPartner.serviceProviderConstraint_restore
+ parameters:
+ - name: crossTenantAccessPolicyConfigurationPartner-tenantId
+ in: path
+ description: The unique identifier of crossTenantAccessPolicyConfigurationPartner
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: crossTenantAccessPolicyConfigurationPartner
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
/policies/deletedItems/crossTenantPartners/$count:
get:
tags:
@@ -39528,7 +39782,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Readonly.'
+ description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
description:
@@ -39546,7 +39800,7 @@ components:
modifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Readonly.'
+ description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
sessionControls:
@@ -40902,7 +41156,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -40929,7 +41183,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -41094,7 +41348,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -41116,7 +41370,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -41151,7 +41405,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -41255,7 +41509,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -41388,6 +41642,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -42250,6 +42510,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.m365CapabilityBase'
description: Defines the partner-specific Microsoft 365 cross-tenant capabilities for inbound access from the partner organization.
x-ms-navigationProperty: true
+ serviceProviderConstraints:
+ $ref: '#/components/schemas/microsoft.graph.serviceProviderConstraints'
additionalProperties:
type: object
microsoft.graph.crossTenantIdentitySyncPolicyPartner:
@@ -42274,6 +42536,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.crossTenantUserSyncInbound'
additionalProperties:
type: object
+ microsoft.graph.serviceProviderConstraints:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.policyDeletableItem'
+ - title: serviceProviderConstraints
+ type: object
+ properties:
+ id:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.policyTemplate:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -46405,6 +46677,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -46812,6 +47086,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -46887,7 +47195,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -47067,7 +47374,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -47434,7 +47741,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -48616,7 +48922,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -48666,6 +48971,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -52153,6 +52463,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -53374,7 +53687,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -53390,13 +53703,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -53526,7 +53839,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -53844,6 +54157,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -54161,6 +54476,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -54330,6 +54689,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -54709,7 +55070,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -54723,6 +55084,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -55093,6 +55458,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -55455,7 +55821,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -55607,7 +55973,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -58148,6 +58514,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -58509,6 +58877,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -58572,6 +58956,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -58821,6 +59210,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -60621,6 +61015,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -60885,7 +61282,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -61751,6 +62148,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -62000,8 +62406,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -62070,6 +62474,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -62460,6 +62889,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -62478,7 +62919,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -65455,12 +65895,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -65494,6 +65937,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -65760,22 +66213,6 @@ components:
- waitingOnOthers
- deferred
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -66032,6 +66469,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -66670,7 +67130,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -67056,6 +67516,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -67338,16 +67799,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -67366,20 +67830,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -67398,16 +67866,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -67426,16 +67897,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -67456,10 +67930,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -67583,6 +68059,7 @@ components:
- sPSharingNotifyUser
- sPSharingGenerateIncidentReport
- restrictWebGrounding
+ - policyTip
type: string
microsoft.graph.labelActionBase:
title: labelActionBase
@@ -68627,6 +69104,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -68848,28 +69327,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -68888,6 +69345,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -70701,6 +71166,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -71321,6 +71802,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -71331,10 +71813,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -71345,6 +71829,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -71355,6 +71840,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -71363,10 +71849,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.conditionalAccessExternalTenantsMembershipKind:
@@ -73032,6 +73520,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -73090,14 +73586,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -74149,6 +74637,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -74163,6 +74654,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/Migrations.yml b/openApiDocs/beta/Migrations.yml
index f2dd881b1f..85b5fb01c8 100644
--- a/openApiDocs/beta/Migrations.yml
+++ b/openApiDocs/beta/Migrations.yml
@@ -162,7 +162,7 @@ paths:
tags:
- solutions.migrationsRoot
summary: Create crossTenantMigrationJob
- description: Create a new crossTenantMigrationJob.
+ description: 'Create a new crossTenantMigrationJob. A job defines the migration batch but doesn''t start validation or migration. After you create the job, call validate to verify tenant and resource configuration, then call migrate to begin the actual migration.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/migrationsroot-post-crosstenantmigrationjobs?view=graph-rest-beta
@@ -353,6 +353,10 @@ paths:
tags:
- solutions.migrationsRoot
summary: Invoke action migrate
+ description: 'Migrate a cross-tenant migration job asynchronously. The job must pass validation before migration can start. After a job is created by using the Create crossTenantMigrationJob method and validated by using the validate action, call this action to start the migration of user data from the source tenant to the target tenant for the specified workloads. Validation results expire after seven days; if expired, revalidate the job before you call the migrate API. This action is asynchronous. After you call the migrate API, poll the Get crossTenantMigrationJob endpoint to check for a terminal status of completed, completedWithErrors, or failed.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/crosstenantmigrationjob-migrate?view=graph-rest-beta
operationId: solution.migration.crossTenantMigrationJob_migrate
parameters:
- name: crossTenantMigrationJob-id
@@ -383,6 +387,10 @@ paths:
tags:
- solutions.migrationsRoot
summary: Invoke action validate
+ description: 'Validate the configuration of a cross-tenant migration job asynchronously. This action doesn''t migrate any content, but goes through validation for the specified workloads to find any errors or misconfigurations that affect an actual migration job. The job must be in a submitted or validateFailed status before you can call this action. This action is asynchronous. After you call the validate API, poll the Get crossTenantMigrationJob endpoint to check for a terminal status of validatePassed or validateFailed.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/crosstenantmigrationjob-validate?view=graph-rest-beta
operationId: solution.migration.crossTenantMigrationJob_validate
parameters:
- name: crossTenantMigrationJob-id
@@ -886,6 +894,10 @@ paths:
tags:
- solutions.migrationsRoot
summary: Invoke action migrate
+ description: 'Migrate a cross-tenant migration job asynchronously. The job must pass validation before migration can start. After a job is created by using the Create crossTenantMigrationJob method and validated by using the validate action, call this action to start the migration of user data from the source tenant to the target tenant for the specified workloads. Validation results expire after seven days; if expired, revalidate the job before you call the migrate API. This action is asynchronous. After you call the migrate API, poll the Get crossTenantMigrationJob endpoint to check for a terminal status of completed, completedWithErrors, or failed.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/crosstenantmigrationjob-migrate?view=graph-rest-beta
operationId: solution.migration.crossTenantMigrationJob.displayName_migrate
parameters:
- name: displayName
@@ -915,6 +927,10 @@ paths:
tags:
- solutions.migrationsRoot
summary: Invoke action validate
+ description: 'Validate the configuration of a cross-tenant migration job asynchronously. This action doesn''t migrate any content, but goes through validation for the specified workloads to find any errors or misconfigurations that affect an actual migration job. The job must be in a submitted or validateFailed status before you can call this action. This action is asynchronous. After you call the validate API, poll the Get crossTenantMigrationJob endpoint to check for a terminal status of validatePassed or validateFailed.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/crosstenantmigrationjob-validate?view=graph-rest-beta
operationId: solution.migration.crossTenantMigrationJob.displayName_validate
parameters:
- name: displayName
@@ -958,65 +974,6 @@ paths:
removalDate: '2026-07-09'
date: '2023-11-15'
version: 2023-11/PrivatePreview:CrossTenantContentMigrationAPI
- /solutions/migrations/crossTenantMigrationJobs/microsoft.graph.validate:
- post:
- tags:
- - solutions.migrationsRoot
- summary: Invoke action validate
- description: 'Validate the configuration of a crossTenantMigrationJob. This function doesn''t migrate any content, but goes through validation for the specified workloads to find any errors or misconfigurations that would affect an actual migration job. '
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/crosstenantmigrationjob-validate?view=graph-rest-beta
- operationId: solution.migration.crossTenantMigrationJob_validate
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- displayName:
- type: string
- nullable: true
- completeAfterDateTime:
- type: string
- nullable: true
- sourceTenantId:
- type: string
- nullable: true
- exchangeSettings:
- $ref: '#/components/schemas/microsoft.graph.exchangeOnlineCrossTenantMigrationSettings'
- workloads:
- type: array
- items:
- type: string
- nullable: true
- resourceType:
- type: string
- nullable: true
- resources:
- type: array
- items:
- type: string
- nullable: true
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.crossTenantMigrationJob'
- default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2026-07-09'
- date: '2025-07-09'
- version: 2025-07/PrivatePreview:CrossTenantContentMigrationAPI
- x-ms-docs-operation-type: action
components:
schemas:
microsoft.graph.migrationsRoot:
@@ -1042,19 +999,19 @@ components:
completeAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: DateTime after which the migration should be performed
+ description: 'Date and time after which the migration should be performed. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.'
format: date-time
createdBy:
type: string
- description: ID of the user that created the job
+ description: User principal name (UPN) of the user who created the job. Read-only.
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: When the job what created
+ description: 'When the job was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.'
format: date-time
displayName:
type: string
- description: Display name of the job. Must be unique per tenant
+ description: Display name of the job. Must be unique per tenant.
exchangeSettings:
$ref: '#/components/schemas/microsoft.graph.exchangeOnlineCrossTenantMigrationSettings'
jobType:
@@ -1062,38 +1019,38 @@ components:
lastUpdatedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: When this migration job was last updated
+ description: 'When this migration job was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z. Read-only.'
format: date-time
message:
type: string
- description: Status message of the migration job
+ description: Status message of the migration job. Nullable. Read-only.
nullable: true
resources:
type: array
items:
type: string
- description: IDs (GUID) of the resources being migrated with the migration job
+ description: IDs (GUID) of the resources that are migrated with the migration job.
resourceType:
type: string
- description: Type of resource being migrated. Only Users is currently supported
+ description: Type of resource being migrated. Only Users is currently supported.
sourceTenantId:
type: string
- description: ID (GUID) of the tenant that content is being migrated from
+ description: ID (GUID) of the tenant that content is migrated from.
status:
$ref: '#/components/schemas/microsoft.graph.crossTenantMigrationJobStatus'
targetTenantId:
type: string
- description: ID of the tenant that content is being migrated to
+ description: ID of the tenant that content is migrated to. Read-only.
workloads:
type: array
items:
type: string
- description: 'Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint)'
+ description: 'Workloads to migrate. Supported workloads are Teams, Exchange, and ODSP (OneDrive/SharePoint).'
users:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.crossTenantMigrationTask'
- description: Details and status of the users being migrated in this migration job
+ description: Details and status of the users migrated in this migration job.
x-ms-navigationProperty: true
additionalProperties:
type: object
@@ -1132,6 +1089,15 @@ components:
description: Type of migration task. Only Users are supported at this time.
additionalProperties:
type: object
+ microsoft.graph.entity:
+ title: entity
+ type: object
+ properties:
+ id:
+ type: string
+ description: The unique identifier for an entity. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.exchangeOnlineCrossTenantMigrationSettings:
title: exchangeOnlineCrossTenantMigrationSettings
type: object
@@ -1144,15 +1110,6 @@ components:
description: Delivery domain on the target tenant
additionalProperties:
type: object
- microsoft.graph.entity:
- title: entity
- type: object
- properties:
- id:
- type: string
- description: The unique identifier for an entity. Read-only.
- additionalProperties:
- type: object
microsoft.graph.crossTenantMigrationJobType:
title: crossTenantMigrationJobType
enum:
diff --git a/openApiDocs/beta/NetworkAccess.yml b/openApiDocs/beta/NetworkAccess.yml
index b1bddaabea..acc4717025 100644
--- a/openApiDocs/beta/NetworkAccess.yml
+++ b/openApiDocs/beta/NetworkAccess.yml
@@ -11705,7 +11705,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -11732,7 +11732,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -11897,7 +11897,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -11919,7 +11919,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -11954,7 +11954,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -12058,7 +12058,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -12191,6 +12191,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -15687,6 +15693,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -16094,6 +16102,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -16169,7 +16211,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.site:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -16371,7 +16412,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -16738,7 +16779,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -17897,7 +17937,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -17947,6 +17986,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -18658,6 +18702,8 @@ components:
- expired
- enabled
- disabled
+ - creating
+ - revoked
type: string
microsoft.graph.networkaccess.validityDate:
title: validityDate
@@ -19013,7 +19059,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -19336,6 +19382,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -20481,7 +20530,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -20497,13 +20546,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -20633,7 +20682,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -20951,6 +21000,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -21281,6 +21332,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -21450,6 +21545,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -21829,7 +21926,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -21843,6 +21940,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -22365,6 +22466,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -22727,7 +22829,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -22879,7 +22981,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -25396,6 +25498,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -25757,6 +25861,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -25845,6 +25965,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -26094,6 +26219,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -27473,6 +27603,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -28640,6 +28773,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -28889,8 +29031,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -28980,6 +29120,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -29370,6 +29535,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -29388,7 +29565,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -32529,12 +32705,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -32568,6 +32747,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -32860,22 +33049,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -33191,6 +33364,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -33829,7 +34025,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -34215,6 +34411,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -35644,6 +35841,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -35865,28 +36064,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -35905,6 +36082,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -37808,6 +37993,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -38466,16 +38667,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -38494,20 +38698,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -38526,16 +38734,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -38554,16 +38765,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -38584,10 +38798,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -40167,6 +40383,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -40225,14 +40449,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -40937,6 +41153,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -40947,10 +41164,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -40961,6 +41180,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -40971,6 +41191,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -40979,10 +41200,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
@@ -41308,6 +41531,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -41322,6 +41548,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
diff --git a/openApiDocs/beta/Planner.yml b/openApiDocs/beta/Planner.yml
index 15f0918353..ff945046e9 100644
--- a/openApiDocs/beta/Planner.yml
+++ b/openApiDocs/beta/Planner.yml
@@ -2531,187 +2531,12 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.archive':
- post:
- tags:
- - groups.plannerGroup
- summary: Invoke action archive
- description: 'Archive a plannerPlan object. Archiving a plan, also archives the plannerTasks and plannerBuckets in the plan. An archived entity is read-only. Archived entities cannot be updated. An archived plan can be unarchived. All archived entities can be deleted. Archived tasks are not included in the response for list of tasks assigned to a user. '
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannerplan-archive?view=graph-rest-beta
- operationId: group.planner.plan_archive
- parameters:
- - name: group-id
- in: path
- description: The unique identifier of group
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: group
- - name: plannerPlan-id
- in: path
- description: The unique identifier of plannerPlan
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerPlan
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- justification:
- type: string
- nullable: true
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.getUsageRights()':
- get:
- tags:
- - groups.plannerGroup
- summary: Invoke function getUsageRights
- operationId: group.planner.plan_getUsageRight
- parameters:
- - name: group-id
- in: path
- description: The unique identifier of group
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: group
- - name: plannerPlan-id
- in: path
- description: The unique identifier of plannerPlan
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerPlan
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.planUsageRight'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: function
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.moveToContainer':
- post:
- tags:
- - groups.plannerGroup
- summary: Invoke action moveToContainer
- description: Move a planner plan object from one planner plan container to another. Planner plans can only be moved from a user container to a group container.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannerplan-movetocontainer?view=graph-rest-beta
- operationId: group.planner.plan_moveToContainer
- parameters:
- - name: group-id
- in: path
- description: The unique identifier of group
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: group
- - name: plannerPlan-id
- in: path
- description: The unique identifier of plannerPlan
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerPlan
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- container:
- $ref: '#/components/schemas/microsoft.graph.plannerPlanContainer'
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerPlan'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.unarchive':
- post:
- tags:
- - groups.plannerGroup
- summary: Invoke action unarchive
- description: 'Unarchive a plannerPlan object. Unarchiving a plan, also unarchives the plannerTasks and plannerBuckets in the plan. Only a plan that is archived can be unarchived.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannerplan-unarchive?view=graph-rest-beta
- operationId: group.planner.plan_unarchive
- parameters:
- - name: group-id
- in: path
- description: The unique identifier of group
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: group
- - name: plannerPlan-id
- in: path
- description: The unique identifier of plannerPlan
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerPlan
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- justification:
- type: string
- nullable: true
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks':
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/historyItems':
get:
tags:
- groups.plannerGroup
- summary: Get tasks from groups
- description: Collection of tasks in the plan. Read-only. Nullable.
- operationId: group.planner.plan_ListTask
+ summary: Get historyItems from groups
+ operationId: group.planner.plan_ListHistoryItem
parameters:
- name: group-id
in: path
@@ -2766,7 +2591,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.plannerTaskCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.plannerHistoryItemCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -2776,8 +2601,8 @@ paths:
post:
tags:
- groups.plannerGroup
- summary: Create new navigation property to tasks for groups
- operationId: group.planner.plan_CreateTask
+ summary: Create new navigation property to historyItems for groups
+ operationId: group.planner.plan_CreateHistoryItem
parameters:
- name: group-id
in: path
@@ -2800,7 +2625,7 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
required: true
responses:
2XX:
@@ -2808,17 +2633,16 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}':
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/historyItems/{plannerHistoryItem-id}':
get:
tags:
- groups.plannerGroup
- summary: Get tasks from groups
- description: Collection of tasks in the plan. Read-only. Nullable.
- operationId: group.planner.plan_GetTask
+ summary: Get historyItems from groups
+ operationId: group.planner.plan_GetHistoryItem
parameters:
- name: group-id
in: path
@@ -2836,14 +2660,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
+ - name: plannerHistoryItem-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of plannerHistoryItem
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
+ x-ms-docs-key-type: plannerHistoryItem
- name: $select
in: query
description: Select properties to be returned
@@ -2870,15 +2694,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.plannerGroup
- summary: Update the navigation property tasks in groups
- operationId: group.planner.plan_UpdateTask
+ summary: Update the navigation property historyItems in groups
+ operationId: group.planner.plan_UpdateHistoryItem
parameters:
- name: group-id
in: path
@@ -2896,20 +2720,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
+ - name: plannerHistoryItem-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of plannerHistoryItem
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
+ x-ms-docs-key-type: plannerHistoryItem
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
required: true
responses:
2XX:
@@ -2917,15 +2741,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.plannerGroup
- summary: Delete navigation property tasks for groups
- operationId: group.planner.plan_DeleteTask
+ summary: Delete navigation property historyItems for groups
+ operationId: group.planner.plan_DeleteHistoryItem
parameters:
- name: group-id
in: path
@@ -2943,14 +2767,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
+ - name: plannerHistoryItem-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of plannerHistoryItem
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
+ x-ms-docs-key-type: plannerHistoryItem
- name: If-Match
in: header
description: ETag
@@ -2963,13 +2787,12 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat':
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/historyItems/$count':
get:
tags:
- groups.plannerGroup
- summary: Get assignedToTaskBoardFormat from groups
- description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
- operationId: group.planner.plan.task_GetAssignedToTaskBoardFormat
+ summary: Get the number of the resource
+ operationId: group.planner.plan.historyItem_GetCount
parameters:
- name: group-id
in: path
@@ -2987,49 +2810,23 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTask
- - name: $select
- in: query
- description: Select properties to be returned
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- - name: $expand
- in: query
- description: Expand related entities
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Retrieved navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.archive':
+ post:
tags:
- groups.plannerGroup
- summary: Update the navigation property assignedToTaskBoardFormat in groups
- operationId: group.planner.plan.task_UpdateAssignedToTaskBoardFormat
+ summary: Invoke action archive
+ description: 'Archive a plannerPlan object. Archiving a plan, also archives the plannerTasks and plannerBuckets in the plan. An archived entity is read-only. Archived entities cannot be updated. An archived plan can be unarchived. All archived entities can be deleted. Archived tasks are not included in the response for list of tasks assigned to a user. '
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannerplan-archive?view=graph-rest-beta
+ operationId: group.planner.plan_archive
parameters:
- name: group-id
in: path
@@ -3047,43 +2844,68 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ justification:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.getUsageRights()':
+ get:
+ tags:
+ - groups.plannerGroup
+ summary: Invoke function getUsageRights
+ operationId: group.planner.plan_getUsageRight
+ parameters:
+ - name: group-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of group
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag value.
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
required: true
style: simple
schema:
type: string
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
- required: true
+ x-ms-docs-key-type: plannerPlan
responses:
2XX:
description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
+ $ref: '#/components/schemas/microsoft.graph.planUsageRight'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: function
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.moveToContainer':
+ post:
tags:
- groups.plannerGroup
- summary: Delete navigation property assignedToTaskBoardFormat for groups
- operationId: group.planner.plan.task_DeleteAssignedToTaskBoardFormat
+ summary: Invoke action moveToContainer
+ description: Move a planner plan object from one planner plan container to another. Planner plans can only be moved from a user container to a group container.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannerplan-movetocontainer?view=graph-rest-beta
+ operationId: group.planner.plan_moveToContainer
parameters:
- name: group-id
in: path
@@ -3101,33 +2923,81 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ container:
+ $ref: '#/components/schemas/microsoft.graph.plannerPlanContainer'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerPlan'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/microsoft.graph.unarchive':
+ post:
+ tags:
+ - groups.plannerGroup
+ summary: Invoke action unarchive
+ description: 'Unarchive a plannerPlan object. Unarchiving a plan, also unarchives the plannerTasks and plannerBuckets in the plan. Only a plan that is archived can be unarchived.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannerplan-unarchive?view=graph-rest-beta
+ operationId: group.planner.plan_unarchive
+ parameters:
+ - name: group-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of group
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
style: simple
schema:
type: string
+ x-ms-docs-key-type: plannerPlan
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ justification:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat':
+ x-ms-docs-operation-type: action
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks':
get:
tags:
- groups.plannerGroup
- summary: Get bucketTaskBoardFormat from groups
- description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
- operationId: group.planner.plan.task_GetBucketTaskBoardFormat
+ summary: Get tasks from groups
+ description: Collection of tasks in the plan. Read-only. Nullable.
+ operationId: group.planner.plan_ListTask
parameters:
- name: group-id
in: path
@@ -3145,14 +3015,21 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
schema:
- type: string
- x-ms-docs-key-type: plannerTask
+ uniqueItems: true
+ type: array
+ items:
+ type: string
- name: $select
in: query
description: Select properties to be returned
@@ -3175,19 +3052,18 @@ paths:
type: string
responses:
2XX:
- description: Retrieved navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
+ $ref: '#/components/responses/microsoft.graph.plannerTaskCollectionResponse'
default:
$ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
x-ms-docs-operation-type: operation
- patch:
+ post:
tags:
- groups.plannerGroup
- summary: Update the navigation property bucketTaskBoardFormat in groups
- operationId: group.planner.plan.task_UpdateBucketTaskBoardFormat
+ summary: Create new navigation property to tasks for groups
+ operationId: group.planner.plan_CreateTask
parameters:
- name: group-id
in: path
@@ -3205,87 +3081,30 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag value.
- required: true
- style: simple
- schema:
- type: string
requestBody:
- description: New navigation property values
+ description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
required: true
responses:
2XX:
- description: Success
+ description: Created navigation property.
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
- tags:
- - groups.plannerGroup
- summary: Delete navigation property bucketTaskBoardFormat for groups
- operationId: group.planner.plan.task_DeleteBucketTaskBoardFormat
- parameters:
- - name: group-id
- in: path
- description: The unique identifier of group
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: group
- - name: plannerPlan-id
- in: path
- description: The unique identifier of plannerPlan
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerPlan
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
- responses:
- 2XX:
- description: Success
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/details':
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}':
get:
tags:
- groups.plannerGroup
- summary: Get details from groups
- description: Read-only. Nullable. More details about the task.
- operationId: group.planner.plan.task_GetDetail
+ summary: Get tasks from groups
+ description: Collection of tasks in the plan. Read-only. Nullable.
+ operationId: group.planner.plan_GetTask
parameters:
- name: group-id
in: path
@@ -3337,15 +3156,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.plannerGroup
- summary: Update the navigation property details in groups
- operationId: group.planner.plan.task_UpdateDetail
+ summary: Update the navigation property tasks in groups
+ operationId: group.planner.plan_UpdateTask
parameters:
- name: group-id
in: path
@@ -3371,19 +3190,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag value.
- required: true
- style: simple
- schema:
- type: string
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
required: true
responses:
2XX:
@@ -3391,15 +3203,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.plannerGroup
- summary: Delete navigation property details for groups
- operationId: group.planner.plan.task_DeleteDetail
+ summary: Delete navigation property tasks for groups
+ operationId: group.planner.plan_DeleteTask
parameters:
- name: group-id
in: path
@@ -3437,13 +3249,13 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages':
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/assignedToTaskBoardFormat':
get:
tags:
- groups.plannerGroup
- summary: Get messages from groups
- description: Read-only. Nullable. Chat messages associated with the task.
- operationId: group.planner.plan.task_ListMessage
+ summary: Get assignedToTaskBoardFormat from groups
+ description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by assignedTo.
+ operationId: group.planner.plan.task_GetAssignedToTaskBoardFormat
parameters:
- name: group-id
in: path
@@ -3469,21 +3281,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- - $ref: '#/components/parameters/count'
- - name: $orderby
- in: query
- description: Order items by property values
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- name: $select
in: query
description: Select properties to be returned
@@ -3506,18 +3303,19 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.plannerTaskChatMessageCollectionResponse'
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
x-ms-docs-operation-type: operation
- post:
+ patch:
tags:
- groups.plannerGroup
- summary: Create new navigation property to messages for groups
- operationId: group.planner.plan.task_CreateMessage
+ summary: Update the navigation property assignedToTaskBoardFormat in groups
+ operationId: group.planner.plan.task_UpdateAssignedToTaskBoardFormat
parameters:
- name: group-id
in: path
@@ -3543,30 +3341,35 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
+ - name: If-Match
+ in: header
+ description: ETag value.
+ required: true
+ style: simple
+ schema:
+ type: string
requestBody:
- description: New navigation property
+ description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}':
- get:
+ delete:
tags:
- groups.plannerGroup
- summary: Get messages from groups
- description: Read-only. Nullable. Chat messages associated with the task.
- operationId: group.planner.plan.task_GetMessage
+ summary: Delete navigation property assignedToTaskBoardFormat for groups
+ operationId: group.planner.plan.task_DeleteAssignedToTaskBoardFormat
parameters:
- name: group-id
in: path
@@ -3592,14 +3395,50 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/bucketTaskBoardFormat':
+ get:
+ tags:
+ - groups.plannerGroup
+ summary: Get bucketTaskBoardFormat from groups
+ description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by bucket.
+ operationId: group.planner.plan.task_GetBucketTaskBoardFormat
+ parameters:
+ - name: group-id
in: path
- description: The unique identifier of plannerTaskChatMessage
+ description: The unique identifier of group
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTaskChatMessage
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
- name: $select
in: query
description: Select properties to be returned
@@ -3626,15 +3465,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.plannerGroup
- summary: Update the navigation property messages in groups
- operationId: group.planner.plan.task_UpdateMessage
+ summary: Update the navigation property bucketTaskBoardFormat in groups
+ operationId: group.planner.plan.task_UpdateBucketTaskBoardFormat
parameters:
- name: group-id
in: path
@@ -3660,20 +3499,19 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
- in: path
- description: The unique identifier of plannerTaskChatMessage
+ - name: If-Match
+ in: header
+ description: ETag value.
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTaskChatMessage
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
required: true
responses:
2XX:
@@ -3681,15 +3519,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.plannerGroup
- summary: Delete navigation property messages for groups
- operationId: group.planner.plan.task_DeleteMessage
+ summary: Delete navigation property bucketTaskBoardFormat for groups
+ operationId: group.planner.plan.task_DeleteBucketTaskBoardFormat
parameters:
- name: group-id
in: path
@@ -3715,14 +3553,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
- in: path
- description: The unique identifier of plannerTaskChatMessage
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTaskChatMessage
- name: If-Match
in: header
description: ETag
@@ -3735,16 +3565,13 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}/microsoft.graph.setReaction':
- post:
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/details':
+ get:
tags:
- groups.plannerGroup
- summary: Invoke action setReaction
- description: Set a reaction to a plannerTaskChatMessage for the current user.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannertaskchatmessage-setreaction?view=graph-rest-beta
- operationId: group.planner.plan.task.message_setReaction
+ summary: Get details from groups
+ description: Read-only. Nullable. More details about the task.
+ operationId: group.planner.plan.task_GetDetail
parameters:
- name: group-id
in: path
@@ -3770,42 +3597,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
- in: path
- description: The unique identifier of plannerTaskChatMessage
- required: true
- style: simple
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
schema:
- type: string
- x-ms-docs-key-type: plannerTaskChatMessage
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- reactionType:
- type: string
- additionalProperties:
- type: object
- required: true
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
responses:
2XX:
- description: Success
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}/microsoft.graph.unsetReaction':
- post:
+ x-ms-docs-operation-type: operation
+ patch:
tags:
- groups.plannerGroup
- summary: Invoke action unsetReaction
- description: Remove a reaction from a plannerTaskChatMessage for the current user.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannertaskchatmessage-unsetreaction?view=graph-rest-beta
- operationId: group.planner.plan.task.message_unsetReaction
+ summary: Update the navigation property details in groups
+ operationId: group.planner.plan.task_UpdateDetail
parameters:
- name: group-id
in: path
@@ -3831,38 +3657,35 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
- in: path
- description: The unique identifier of plannerTaskChatMessage
+ - name: If-Match
+ in: header
+ description: ETag value.
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTaskChatMessage
requestBody:
- description: Action parameters
+ description: New navigation property values
content:
application/json:
schema:
- type: object
- properties:
- reactionType:
- type: string
- additionalProperties:
- type: object
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/$count':
- get:
+ x-ms-docs-operation-type: operation
+ delete:
tags:
- groups.plannerGroup
- summary: Get the number of the resource
- operationId: group.planner.plan.task.message_GetCount
+ summary: Delete navigation property details for groups
+ operationId: group.planner.plan.task_DeleteDetail
parameters:
- name: group-id
in: path
@@ -3888,20 +3711,25 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/progressTaskBoardFormat':
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages':
get:
tags:
- groups.plannerGroup
- summary: Get progressTaskBoardFormat from groups
- description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
- operationId: group.planner.plan.task_GetProgressTaskBoardFormat
+ summary: Get messages from groups
+ description: Read-only. Nullable. Chat messages associated with the task.
+ operationId: group.planner.plan.task_ListMessage
parameters:
- name: group-id
in: path
@@ -3927,7 +3755,465 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: $select
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.plannerTaskChatMessageCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - groups.plannerGroup
+ summary: Create new navigation property to messages for groups
+ operationId: group.planner.plan.task_CreateMessage
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}':
+ get:
+ tags:
+ - groups.plannerGroup
+ summary: Get messages from groups
+ description: Read-only. Nullable. Chat messages associated with the task.
+ operationId: group.planner.plan.task_GetMessage
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - groups.plannerGroup
+ summary: Update the navigation property messages in groups
+ operationId: group.planner.plan.task_UpdateMessage
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - groups.plannerGroup
+ summary: Delete navigation property messages for groups
+ operationId: group.planner.plan.task_DeleteMessage
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}/microsoft.graph.setReaction':
+ post:
+ tags:
+ - groups.plannerGroup
+ summary: Invoke action setReaction
+ description: Set a reaction to a plannerTaskChatMessage for the current user.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannertaskchatmessage-setreaction?view=graph-rest-beta
+ operationId: group.planner.plan.task.message_setReaction
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ reactionType:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/{plannerTaskChatMessage-id}/microsoft.graph.unsetReaction':
+ post:
+ tags:
+ - groups.plannerGroup
+ summary: Invoke action unsetReaction
+ description: Remove a reaction from a plannerTaskChatMessage for the current user.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannertaskchatmessage-unsetreaction?view=graph-rest-beta
+ operationId: group.planner.plan.task.message_unsetReaction
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ reactionType:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/messages/$count':
+ get:
+ tags:
+ - groups.plannerGroup
+ summary: Get the number of the resource
+ operationId: group.planner.plan.task.message_GetCount
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/groups/{group-id}/planner/plans/{plannerPlan-id}/tasks/{plannerTask-id}/progressTaskBoardFormat':
+ get:
+ tags:
+ - groups.plannerGroup
+ summary: Get progressTaskBoardFormat from groups
+ description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
+ operationId: group.planner.plan.task_GetProgressTaskBoardFormat
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: $select
in: query
description: Select properties to be returned
style: form
@@ -7957,8 +8243,251 @@ paths:
delete:
tags:
- planner.plannerPlan
- summary: Delete navigation property details for planner
- operationId: planner.plan_DeleteDetail
+ summary: Delete navigation property details for planner
+ operationId: planner.plan_DeleteDetail
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/planner/plans/{plannerPlan-id}/historyItems':
+ get:
+ tags:
+ - planner.plannerPlan
+ summary: Get historyItems from planner
+ operationId: planner.plan_ListHistoryItem
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.plannerHistoryItemCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - planner.plannerPlan
+ summary: Create new navigation property to historyItems for planner
+ operationId: planner.plan_CreateHistoryItem
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/planner/plans/{plannerPlan-id}/historyItems/{plannerHistoryItem-id}':
+ get:
+ tags:
+ - planner.plannerPlan
+ summary: Get historyItems from planner
+ operationId: planner.plan_GetHistoryItem
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - planner.plannerPlan
+ summary: Update the navigation property historyItems in planner
+ operationId: planner.plan_UpdateHistoryItem
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - planner.plannerPlan
+ summary: Delete navigation property historyItems for planner
+ operationId: planner.plan_DeleteHistoryItem
+ parameters:
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/planner/plans/{plannerPlan-id}/historyItems/$count':
+ get:
+ tags:
+ - planner.plannerPlan
+ summary: Get the number of the resource
+ operationId: planner.plan.historyItem_GetCount
parameters:
- name: plannerPlan-id
in: path
@@ -7968,18 +8497,13 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Success
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
'/planner/plans/{plannerPlan-id}/microsoft.graph.archive':
post:
tags:
@@ -13673,38 +14197,266 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerTask
- - name: plannerTaskChatMessage-id
- in: path
- description: The unique identifier of plannerTaskChatMessage
- required: true
+ - name: plannerTaskChatMessage-id
+ in: path
+ description: The unique identifier of plannerTaskChatMessage
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTaskChatMessage
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ reactionType:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/messages/$count':
+ get:
+ tags:
+ - users.plannerUser
+ summary: Get the number of the resource
+ operationId: user.planner.plan.bucket.task.message_GetCount
+ parameters:
+ - name: user-id
+ in: path
+ description: The unique identifier of user
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerBucket-id
+ in: path
+ description: The unique identifier of plannerBucket
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerBucket
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat':
+ get:
+ tags:
+ - users.plannerUser
+ summary: Get progressTaskBoardFormat from users
+ description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
+ operationId: user.planner.plan.bucket.task_GetProgressTaskBoardFormat
+ parameters:
+ - name: user-id
+ in: path
+ description: The unique identifier of user
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerBucket-id
+ in: path
+ description: The unique identifier of plannerBucket
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerBucket
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.plannerUser
+ summary: Update the navigation property progressTaskBoardFormat in users
+ operationId: user.planner.plan.bucket.task_UpdateProgressTaskBoardFormat
+ parameters:
+ - name: user-id
+ in: path
+ description: The unique identifier of user
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerBucket-id
+ in: path
+ description: The unique identifier of plannerBucket
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerBucket
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: If-Match
+ in: header
+ description: ETag value.
+ required: true
+ style: simple
+ schema:
+ type: string
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.plannerUser
+ summary: Delete navigation property progressTaskBoardFormat for users
+ operationId: user.planner.plan.bucket.task_DeleteProgressTaskBoardFormat
+ parameters:
+ - name: user-id
+ in: path
+ description: The unique identifier of user
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
+ in: path
+ description: The unique identifier of plannerPlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerPlan
+ - name: plannerBucket-id
+ in: path
+ description: The unique identifier of plannerBucket
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerBucket
+ - name: plannerTask-id
+ in: path
+ description: The unique identifier of plannerTask
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerTask
+ - name: If-Match
+ in: header
+ description: ETag
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTaskChatMessage
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- reactionType:
- type: string
- additionalProperties:
- type: object
- required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/messages/$count':
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/$count':
get:
tags:
- users.plannerUser
summary: Get the number of the resource
- operationId: user.planner.plan.bucket.task.message_GetCount
+ operationId: user.planner.plan.bucket.task_GetCount
parameters:
- name: user-id
in: path
@@ -13730,14 +14482,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerBucket
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTask
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -13745,13 +14489,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/{plannerTask-id}/progressTaskBoardFormat':
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/microsoft.graph.delta()':
get:
tags:
- users.plannerUser
- summary: Get progressTaskBoardFormat from users
- description: Read-only. Nullable. Used to render the task correctly in the task board view when grouped by progress.
- operationId: user.planner.plan.bucket.task_GetProgressTaskBoardFormat
+ summary: Invoke function delta
+ description: 'Get newly created, updated, or deleted tasks in either a Planner plan or assigned to the signed-in user without having to perform a full read of the entire resource collection. For details, see Use delta query to track changes in Microsoft Graph data.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannertask-delta?view=graph-rest-beta
+ operationId: user.planner.plan.bucket.task_delta
parameters:
- name: user-id
in: path
@@ -13777,14 +14524,11 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerBucket
- - name: plannerTask-id
- in: path
- description: The unique identifier of plannerTask
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerTask
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
@@ -13795,6 +14539,16 @@ paths:
type: array
items:
type: string
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
- name: $expand
in: query
description: Expand related entities
@@ -13807,19 +14561,37 @@ paths:
type: string
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
+ title: Collection of plannerTask
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerTask'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ '@odata.deltaLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/$count':
+ get:
tags:
- users.plannerUser
- summary: Update the navigation property progressTaskBoardFormat in users
- operationId: user.planner.plan.bucket.task_UpdateProgressTaskBoardFormat
+ summary: Get the number of the resource
+ operationId: user.planner.plan.bucket_GetCount
parameters:
- name: user-id
in: path
@@ -13837,51 +14609,109 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerBucket-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.plannerUser
+ summary: Invoke function delta
+ description: 'Get newly created, updated, or deleted buckets in a Planner plan without having to perform a full read of the entire resource collection. For details, see Use delta query to track changes in Microsoft Graph data.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/plannerbucket-delta?view=graph-rest-beta
+ operationId: user.planner.plan.bucket_delta
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of plannerBucket
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerBucket
- - name: plannerTask-id
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of plannerPlan
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
- - name: If-Match
- in: header
- description: ETag value.
- required: true
- style: simple
+ x-ms-docs-key-type: plannerPlan
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
schema:
- type: string
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
- required: true
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat'
+ title: Collection of plannerBucket
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerBucket'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ '@odata.deltaLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/details':
+ get:
tags:
- users.plannerUser
- summary: Delete navigation property progressTaskBoardFormat for users
- operationId: user.planner.plan.bucket.task_DeleteProgressTaskBoardFormat
+ summary: Get details from users
+ description: Extra details about the plan. Read-only. Nullable.
+ operationId: user.planner.plan_GetDetail
parameters:
- name: user-id
in: path
@@ -13899,40 +14729,87 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerBucket-id
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.plannerUser
+ summary: Update the navigation property details in users
+ operationId: user.planner.plan_UpdateDetail
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of plannerBucket
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerBucket
- - name: plannerTask-id
+ x-ms-docs-key-type: user
+ - name: plannerPlan-id
in: path
- description: The unique identifier of plannerTask
+ description: The unique identifier of plannerPlan
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerTask
+ x-ms-docs-key-type: plannerPlan
- name: If-Match
in: header
- description: ETag
+ description: ETag value.
+ required: true
style: simple
schema:
type: string
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/$count':
- get:
+ delete:
tags:
- users.plannerUser
- summary: Get the number of the resource
- operationId: user.planner.plan.bucket.task_GetCount
+ summary: Delete navigation property details for users
+ operationId: user.planner.plan_DeleteDetail
parameters:
- name: user-id
in: path
@@ -13950,31 +14827,24 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerBucket-id
- in: path
- description: The unique identifier of plannerBucket
- required: true
+ - name: If-Match
+ in: header
+ description: ETag
style: simple
schema:
type: string
- x-ms-docs-key-type: plannerBucket
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/{plannerBucket-id}/tasks/microsoft.graph.delta()':
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/historyItems':
get:
tags:
- users.plannerUser
- summary: Invoke function delta
- description: 'Get newly created, updated, or deleted tasks in either a Planner plan or assigned to the signed-in user without having to perform a full read of the entire resource collection. For details, see Use delta query to track changes in Microsoft Graph data.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannertask-delta?view=graph-rest-beta
- operationId: user.planner.plan.bucket.task_delta
+ summary: Get historyItems from users
+ operationId: user.planner.plan_ListHistoryItem
parameters:
- name: user-id
in: path
@@ -13992,22 +14862,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: plannerBucket-id
- in: path
- description: The unique identifier of plannerBucket
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: plannerBucket
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- - name: $select
+ - name: $orderby
in: query
- description: Select properties to be returned
+ description: Order items by property values
style: form
explode: false
schema:
@@ -14015,9 +14877,9 @@ paths:
type: array
items:
type: string
- - name: $orderby
+ - name: $select
in: query
- description: Order items by property values
+ description: Select properties to be returned
style: form
explode: false
schema:
@@ -14037,37 +14899,18 @@ paths:
type: string
responses:
2XX:
- description: Success
- content:
- application/json:
- schema:
- title: Collection of plannerTask
- type: object
- properties:
- value:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.plannerTask'
- '@odata.nextLink':
- type: string
- nullable: true
- '@odata.deltaLink':
- type: string
- nullable: true
- additionalProperties:
- type: object
+ $ref: '#/components/responses/microsoft.graph.plannerHistoryItemCollectionResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/$count':
- get:
+ x-ms-docs-operation-type: operation
+ post:
tags:
- users.plannerUser
- summary: Get the number of the resource
- operationId: user.planner.plan.bucket_GetCount
+ summary: Create new navigation property to historyItems for users
+ operationId: user.planner.plan_CreateHistoryItem
parameters:
- name: user-id
in: path
@@ -14085,23 +14928,29 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/planner/plans/{plannerPlan-id}/buckets/microsoft.graph.delta()':
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/historyItems/{plannerHistoryItem-id}':
get:
tags:
- users.plannerUser
- summary: Invoke function delta
- description: 'Get newly created, updated, or deleted buckets in a Planner plan without having to perform a full read of the entire resource collection. For details, see Use delta query to track changes in Microsoft Graph data.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/plannerbucket-delta?view=graph-rest-beta
- operationId: user.planner.plan.bucket_delta
+ summary: Get historyItems from users
+ operationId: user.planner.plan_GetHistoryItem
parameters:
- name: user-id
in: path
@@ -14119,11 +14968,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- - $ref: '#/components/parameters/count'
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
- name: $select
in: query
description: Select properties to be returned
@@ -14134,16 +14986,6 @@ paths:
type: array
items:
type: string
- - name: $orderby
- in: query
- description: Order items by property values
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- name: $expand
in: query
description: Expand related entities
@@ -14156,38 +14998,19 @@ paths:
type: string
responses:
2XX:
- description: Success
+ description: Retrieved navigation property
content:
application/json:
schema:
- title: Collection of plannerBucket
- type: object
- properties:
- value:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.plannerBucket'
- '@odata.nextLink':
- type: string
- nullable: true
- '@odata.deltaLink':
- type: string
- nullable: true
- additionalProperties:
- type: object
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: function
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- '/users/{user-id}/planner/plans/{plannerPlan-id}/details':
- get:
+ x-ms-docs-operation-type: operation
+ patch:
tags:
- users.plannerUser
- summary: Get details from users
- description: Extra details about the plan. Read-only. Nullable.
- operationId: user.planner.plan_GetDetail
+ summary: Update the navigation property historyItems in users
+ operationId: user.planner.plan_UpdateHistoryItem
parameters:
- name: user-id
in: path
@@ -14205,41 +15028,36 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: $select
- in: query
- description: Select properties to be returned
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- - name: $expand
- in: query
- description: Expand related entities
- style: form
- explode: false
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- patch:
+ delete:
tags:
- users.plannerUser
- summary: Update the navigation property details in users
- operationId: user.planner.plan_UpdateDetail
+ summary: Delete navigation property historyItems for users
+ operationId: user.planner.plan_DeleteHistoryItem
parameters:
- name: user-id
in: path
@@ -14257,35 +15075,32 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
+ - name: plannerHistoryItem-id
+ in: path
+ description: The unique identifier of plannerHistoryItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: plannerHistoryItem
- name: If-Match
in: header
- description: ETag value.
- required: true
+ description: ETag
style: simple
schema:
type: string
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
- required: true
responses:
2XX:
description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- delete:
+ '/users/{user-id}/planner/plans/{plannerPlan-id}/historyItems/$count':
+ get:
tags:
- users.plannerUser
- summary: Delete navigation property details for users
- operationId: user.planner.plan_DeleteDetail
+ summary: Get the number of the resource
+ operationId: user.planner.plan.historyItem_GetCount
parameters:
- name: user-id
in: path
@@ -14303,18 +15118,13 @@ paths:
schema:
type: string
x-ms-docs-key-type: plannerPlan
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Success
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
'/users/{user-id}/planner/plans/{plannerPlan-id}/microsoft.graph.archive':
post:
tags:
@@ -17649,6 +18459,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -17964,6 +18779,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.planUsageRight:
title: planUsageRight
type: object
@@ -18507,6 +19345,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.usageRightsInfo:
title: usageRightsInfo
type: object
@@ -18629,6 +19483,19 @@ components:
ODataCountResponse:
type: integer
format: int32
+ microsoft.graph.plannerHistoryItemCollectionResponse:
+ title: Collection of plannerHistoryItem
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.plannerRosterCollectionResponse:
title: Collection of plannerRoster
type: object
@@ -18970,6 +19837,12 @@ components:
text/plain:
schema:
$ref: '#/components/schemas/ODataCountResponse'
+ microsoft.graph.plannerHistoryItemCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItemCollectionResponse'
microsoft.graph.plannerRosterCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/beta/Search.yml b/openApiDocs/beta/Search.yml
index 3c223ff306..abdbd822db 100644
--- a/openApiDocs/beta/Search.yml
+++ b/openApiDocs/beta/Search.yml
@@ -5555,6 +5555,8 @@ components:
description: An array of access control entries. Each entry specifies the access granted to a user or group. Required.
content:
$ref: '#/components/schemas/microsoft.graph.externalConnectors.externalItemContent'
+ informationProtectionLabel:
+ $ref: '#/components/schemas/microsoft.graph.externalConnectors.externalItemInformationProtectionLabel'
properties:
$ref: '#/components/schemas/microsoft.graph.externalConnectors.properties'
activities:
@@ -6393,6 +6395,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.externalConnectors.externalItemInformationProtectionLabel:
+ title: externalItemInformationProtectionLabel
+ type: object
+ properties:
+ sensitivityLabelId:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.externalConnectors.properties:
title: properties
type: object
@@ -6770,7 +6781,7 @@ components:
description: Indicates Mobile Application Management (MAM) for iOS devices
name: iOSMobileApplicationManagement
- value: unknownFutureValue
- description: Evolvable enumeration sentinel value. Do not use.
+ description: Evolvable enumeration sentinel value. Do not use
name: unknownFutureValue
- value: windowsMobileApplicationManagement
description: Indicates Mobile Application Management (MAM) for Windows devices.
@@ -7412,6 +7423,7 @@ components:
- personLanguages
- personPublications
- personPatents
+ - personWorkPositions
type: string
microsoft.graph.externalConnectors.rankingHint:
title: rankingHint
diff --git a/openApiDocs/beta/Sites.yml b/openApiDocs/beta/Sites.yml
index e8613f38a5..39426781da 100644
--- a/openApiDocs/beta/Sites.yml
+++ b/openApiDocs/beta/Sites.yml
@@ -92611,6 +92611,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -92748,7 +92750,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -92762,6 +92764,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -93008,7 +93014,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -93035,7 +93041,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -93200,7 +93206,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -93222,7 +93228,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -93257,7 +93263,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -93361,7 +93367,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -93494,6 +93500,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -94761,6 +94773,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.onenote:
@@ -95818,8 +95842,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -95909,6 +95931,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -96251,7 +96298,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -98228,6 +98274,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -98859,6 +98907,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -98880,7 +98962,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -98918,7 +98999,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -99285,7 +99366,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -100461,7 +100541,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -100511,6 +100590,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -102767,28 +102851,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -102807,6 +102869,30 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -103225,6 +103311,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -104783,7 +104872,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -104799,13 +104888,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -104935,7 +105024,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -105253,6 +105342,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -105669,6 +105760,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -105789,6 +105924,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -106151,7 +106287,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -106303,7 +106439,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -108649,6 +108785,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -109098,6 +109236,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -109347,6 +109490,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -110799,30 +110947,6 @@ components:
- reactivating
- unknownFutureValue
type: string
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -111155,6 +111279,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -111405,7 +111532,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -112534,6 +112661,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -114578,12 +114714,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -114617,6 +114756,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -115224,6 +115373,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -115862,7 +116034,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -116248,6 +116420,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -118035,6 +118208,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -119191,6 +119366,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -119792,6 +119983,7 @@ components:
- sPSharingNotifyUser
- sPSharingGenerateIncidentReport
- restrictWebGrounding
+ - policyTip
type: string
microsoft.graph.labelActionBase:
title: labelActionBase
@@ -121788,6 +121980,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -122450,16 +122650,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -122478,20 +122681,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -122510,16 +122717,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -122538,16 +122748,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -122568,10 +122781,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -122768,6 +122983,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -122782,6 +123000,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -122892,6 +123117,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -122902,10 +123128,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -122916,6 +123144,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -122926,6 +123155,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -122934,10 +123164,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Users.Actions.yml b/openApiDocs/beta/Users.Actions.yml
index 565f46e401..855f5e2151 100644
--- a/openApiDocs/beta/Users.Actions.yml
+++ b/openApiDocs/beta/Users.Actions.yml
@@ -1282,7 +1282,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -1309,7 +1309,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -1474,7 +1474,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -1496,7 +1496,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -1531,7 +1531,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -1635,7 +1635,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -1768,6 +1768,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -3923,6 +3929,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -4554,6 +4562,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -4629,7 +4671,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.site:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -4831,7 +4872,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -5198,7 +5239,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -6268,7 +6308,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -6318,6 +6357,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -7231,6 +7275,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -8742,7 +8789,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -8758,13 +8805,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -8894,7 +8941,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -9212,6 +9259,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -9627,6 +9676,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -9796,6 +9889,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -10175,7 +10270,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -10189,6 +10284,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -10711,6 +10810,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -11073,7 +11173,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -11225,7 +11325,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -13696,6 +13796,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -14057,6 +14159,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -14145,6 +14263,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -14394,6 +14517,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -15622,6 +15750,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -15910,7 +16041,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -16896,6 +17027,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -17145,8 +17285,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -17236,6 +17374,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -17626,6 +17789,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -17644,7 +17819,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -20778,12 +20952,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -20817,6 +20994,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -21095,22 +21282,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -21426,6 +21597,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -22064,7 +22258,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -22450,6 +22644,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -23691,6 +23886,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -23912,28 +24109,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -23952,6 +24127,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -25855,6 +26038,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -28193,6 +28392,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -28251,14 +28458,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -29205,16 +29404,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -29233,20 +29435,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -29265,16 +29471,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -29293,16 +29502,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -29323,10 +29535,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -29523,6 +29737,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -29537,6 +29754,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -29982,6 +30206,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -29992,10 +30217,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -30006,6 +30233,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -30016,6 +30244,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -30024,10 +30253,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Users.Functions.yml b/openApiDocs/beta/Users.Functions.yml
index e305520021..5ed78f054a 100644
--- a/openApiDocs/beta/Users.Functions.yml
+++ b/openApiDocs/beta/Users.Functions.yml
@@ -657,7 +657,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -684,7 +684,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -849,7 +849,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -871,7 +871,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -906,7 +906,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -1010,7 +1010,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -1143,6 +1143,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -2955,6 +2961,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -3586,6 +3594,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -3661,7 +3703,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -3870,7 +3911,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -4237,7 +4278,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.team:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -5457,7 +5497,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -5507,6 +5546,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -6200,7 +6244,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
eventId:
type: string
- description: The unique ID of the event. Read only.
+ description: The unique ID of the event. Read-only.
nullable: true
eventLocation:
$ref: '#/components/schemas/microsoft.graph.location'
@@ -6281,6 +6325,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -7959,7 +8006,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -7975,13 +8022,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -8111,7 +8158,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -8429,6 +8476,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -8858,6 +8907,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -9027,6 +9120,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -9406,7 +9501,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -9420,6 +9515,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -9942,6 +10041,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -10304,7 +10404,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -10456,7 +10556,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -12961,6 +13061,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -13322,6 +13424,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -13410,6 +13528,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -13659,6 +13782,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -14815,6 +14943,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -15114,7 +15245,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -16252,6 +16383,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -16501,8 +16641,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -16592,6 +16730,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -16982,6 +17145,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -17000,7 +17175,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -20141,12 +20315,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -20180,6 +20357,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -20472,22 +20659,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -20803,6 +20974,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -21441,7 +21635,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -21827,6 +22021,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -23121,6 +23316,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -23342,28 +23539,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -23382,6 +23557,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -25285,6 +25468,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -27623,6 +27822,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -27681,14 +27888,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -28635,16 +28834,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -28663,20 +28865,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -28695,16 +28901,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -28723,16 +28932,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -28753,10 +28965,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -28953,6 +29167,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -28967,6 +29184,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -29412,6 +29636,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -29422,10 +29647,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -29436,6 +29663,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -29446,6 +29674,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -29454,10 +29683,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/Users.yml b/openApiDocs/beta/Users.yml
index 62b30d0d1c..639e0bee6e 100644
--- a/openApiDocs/beta/Users.yml
+++ b/openApiDocs/beta/Users.yml
@@ -148,8 +148,8 @@ paths:
patch:
tags:
- users.user
- summary: Update user or agentUser
- description: Update the properties of a user or agentUser object.
+ summary: Update user
+ description: 'Update the properties of a user. To use this API to update an agentUser, specify an @odata.type property with a value of #microsoft.graph.agentUser in the request body.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/user-update?view=graph-rest-beta
@@ -16811,8 +16811,8 @@ paths:
patch:
tags:
- users.user
- summary: Update user or agentUser
- description: Update the properties of a user or agentUser object.
+ summary: Update user
+ description: 'Update the properties of a user. To use this API to update an agentUser, specify an @odata.type property with a value of #microsoft.graph.agentUser in the request body.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/user-update?view=graph-rest-beta
@@ -16911,7 +16911,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -16938,7 +16938,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -17103,7 +17103,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -17125,7 +17125,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -17160,7 +17160,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -17264,7 +17264,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -17397,6 +17397,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -18242,7 +18248,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -18274,7 +18280,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -18641,7 +18647,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.notification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -21334,6 +21339,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -21741,6 +21748,40 @@ components:
additionalProperties:
type: object
description: Event representing an general failure.
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.drive:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -21816,7 +21857,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.site:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItem'
@@ -23119,13 +23159,17 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.accessReviewInstance:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -24343,6 +24387,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -25116,6 +25161,8 @@ components:
type: boolean
description: Locks the keyCredentials and passwordCredentials properties for modification where credential usage type is Verify. This locks OAuth service principals.
nullable: true
+ enforcementScope:
+ $ref: '#/components/schemas/microsoft.graph.servicePrincipalLockScope'
isEnabled:
type: boolean
description: 'Enables or disables service principal lock configuration. To allow the sensitive properties to be updated, update this property to false to disable the lock on the service principal.'
@@ -25296,7 +25343,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.changeTrackedEntity:
@@ -25960,6 +26007,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -26968,7 +27018,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -26984,13 +27034,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -27120,7 +27170,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -27438,6 +27488,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -27756,6 +27808,50 @@ components:
additionalProperties:
type: object
description: Object containing detailed information about the error and its remediation.
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.baseItem:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -27925,6 +28021,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -28304,7 +28402,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -28318,6 +28416,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -28963,7 +29065,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -29115,7 +29217,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -31601,6 +31703,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -31804,6 +31908,22 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessReviewError:
allOf:
- $ref: '#/components/schemas/microsoft.graph.genericError'
@@ -31892,6 +32012,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -32141,6 +32266,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -33071,7 +33201,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -33691,6 +33821,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.servicePrincipalLockScope:
+ title: servicePrincipalLockScope
+ enum:
+ - notConfigured
+ - foreignTenantOnly
+ - everywhere
+ - unknownFutureValue
+ type: string
microsoft.graph.kind:
title: kind
enum:
@@ -33848,6 +33986,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -34930,6 +35071,15 @@ components:
additionalProperties:
type: object
description: 'Object representing a link to troubleshooting information, the link could be to the Azure Portal or a Microsoft doc.'
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.itemReference:
title: itemReference
type: object
@@ -35179,8 +35329,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -35270,6 +35418,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -35660,6 +35833,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -35678,7 +35863,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -38634,12 +38818,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -38673,6 +38860,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -38926,22 +39123,6 @@ components:
- managerOrSponsor
- unknownFutureValue
type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.accessReviewInstanceDecisionItemPermission:
title: accessReviewInstanceDecisionItemPermission
type: object
@@ -39257,6 +39438,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -39937,6 +40141,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -41300,6 +41505,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -41521,28 +41728,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -41561,6 +41746,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -43369,6 +43562,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerTeamsPublicationInfo:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation'
@@ -45555,6 +45764,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -45613,14 +45830,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -46366,16 +46575,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -46394,20 +46606,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -46426,16 +46642,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -46454,16 +46673,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -46484,10 +46706,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -46844,6 +47068,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -46858,6 +47085,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -47294,6 +47528,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -47304,10 +47539,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -47318,6 +47555,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -47328,6 +47566,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -47336,10 +47575,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/beta/WindowsUpdates.yml b/openApiDocs/beta/WindowsUpdates.yml
index a42857d494..fd6db54e84 100644
--- a/openApiDocs/beta/WindowsUpdates.yml
+++ b/openApiDocs/beta/WindowsUpdates.yml
@@ -1433,7 +1433,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -2028,7 +2028,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -2453,7 +2453,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action updateAudienceById
- description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it does not already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
+ description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it doesn''t already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudiencebyid?view=graph-rest-beta
@@ -3623,7 +3623,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -4215,7 +4215,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -4640,7 +4640,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action updateAudienceById
- description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it does not already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
+ description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it doesn''t already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudiencebyid?view=graph-rest-beta
@@ -8137,7 +8137,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -8315,7 +8315,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action enrollAssets
- description: 'Enroll updatableAsset resources in update management by Windows Autopatch. You can enroll an azureADDevice resource in update management, but may not enroll an updatableAssetGroup in update management. Enrolling a Microsoft Entra device in update management automatically creates an azureADDevice object if it does not already exist. You can also use the method enrollAssetsById to enroll assets.'
+ description: 'Enroll updatableAsset resources in update management by Windows Autopatch. You can enroll an azureADDevice resource in update management, but may not enroll an updatableAssetGroup in update management. Enrolling a Microsoft Entra device in update management automatically creates an azureADDevice object if it doesn''t already exist. You can also use the method enrollAssetsById to enroll assets.'
operationId: admin.window.update.updatableAsset_enrollAsset
requestBody:
description: Action parameters
@@ -9537,7 +9537,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -10129,7 +10129,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action addMembers
- description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.'
+ description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it doesn''t already exist. You can also use the method addMembersById to add members.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta
@@ -10554,7 +10554,7 @@ paths:
tags:
- admin.adminWindows
summary: Invoke action updateAudienceById
- description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it does not already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
+ description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it doesn''t already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudiencebyid?view=graph-rest-beta
@@ -12110,7 +12110,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -12477,7 +12477,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.windowsUpdates.bodyType:
title: bodyType
enum:
@@ -12549,6 +12548,7 @@ components:
- private
- secret
- public
+ - unknownFutureValue
type: string
microsoft.graph.assignedLabel:
title: assignedLabel
@@ -13698,6 +13698,9 @@ components:
- title: usageRight
type: object
properties:
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -14241,6 +14244,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.image'
location:
$ref: '#/components/schemas/microsoft.graph.geoCoordinates'
+ lockInfo:
+ $ref: '#/components/schemas/microsoft.graph.lockInfo'
malware:
$ref: '#/components/schemas/microsoft.graph.malware'
media:
@@ -14644,6 +14649,11 @@ components:
x-ms-navigationProperty: true
details:
$ref: '#/components/schemas/microsoft.graph.plannerPlanDetails'
+ historyItems:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.plannerHistoryItem'
+ x-ms-navigationProperty: true
tasks:
type: array
items:
@@ -14810,7 +14820,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn'
indexed:
type: boolean
- description: Specifies whether the column values can used for sorting and searching.
+ description: Specifies whether the column values can be used for sorting and searching.
nullable: true
isDeletable:
type: boolean
@@ -14824,6 +14834,10 @@ components:
type: boolean
description: Specifies whether the column can be changed.
nullable: true
+ isSearchable:
+ type: boolean
+ description: Specifies whether the column values can be used for searching. Currently supported only for columns in a fileStorageContainer.
+ nullable: true
lookup:
$ref: '#/components/schemas/microsoft.graph.lookupColumn'
name:
@@ -15334,7 +15348,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -15517,7 +15531,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -15544,7 +15558,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -15709,7 +15723,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -15731,7 +15745,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -15766,7 +15780,7 @@ components:
type: array
items:
type: string
- description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -15870,7 +15884,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -16003,6 +16017,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.directoryObject'
description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand.
x-ms-navigationProperty: true
+ distributionLists:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionList'
+ description: The personal distribution lists in the user's mailbox. Read-only. Nullable.
+ x-ms-navigationProperty: true
drive:
$ref: '#/components/schemas/microsoft.graph.drive'
drives:
@@ -16285,7 +16305,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -16551,6 +16571,9 @@ components:
type: number
description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only.
format: int32
+ externalServiceIdentifier:
+ type: string
+ nullable: true
services:
type: array
items:
@@ -17076,8 +17099,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.fileArchiveStatus'
hashes:
$ref: '#/components/schemas/microsoft.graph.hashes'
- lockInfo:
- $ref: '#/components/schemas/microsoft.graph.lockInfo'
mimeType:
type: string
description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only.
@@ -17167,6 +17188,31 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockInfo:
+ title: lockInfo
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock was created, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ expirationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: 'The date and time when the lock expires, in UTC. Read-only.'
+ format: date-time
+ nullable: true
+ lockType:
+ $ref: '#/components/schemas/microsoft.graph.lockType'
+ owners:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The collection of users that currently hold the lock on the file. Read-only.
+ additionalProperties:
+ type: object
microsoft.graph.malware:
title: malware
type: object
@@ -17557,6 +17603,18 @@ components:
resource:
type: string
description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource.
+ vapidPublicKey:
+ type: string
+ description: 'Optional. The application server''s VAPID public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained by calling the getVapidPublicKey function on the subscription collection. The browser passes this value to PushManager.subscribe({ applicationServerKey }) to bind the push subscription to this server identity. Required when notificationUrl targets a known Web Push service origin (for example, *.push.apple.com, fcm.googleapis.com, updates.push.services.mozilla.com); rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8292.'
+ nullable: true
+ webPushEncryptionP256dhPublicKey:
+ type: string
+ description: 'Optional. The subscriber''s ECDH public key, base64url-encoded (P-256 uncompressed point, 65 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''p256dh''). Used as the peer public key during ECDH key agreement to derive the per-message content encryption key for RFC 8291 payload encryption. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
+ webPushEncryptionSecret:
+ type: string
+ description: 'Optional. The subscriber''s auth secret, base64url-encoded (16 bytes pre-encoding). Obtained from the browser via PushSubscription.getKey(''auth''). Used as the HMAC-SHA-256 salt for the HKDF combine step that derives key material for RFC 8291 payload encryption. Write-only: this value is never returned in GET responses (returned as null). Treat as a secret. Required when notificationUrl targets a known Web Push service origin; rejected with 400 Bad Request if supplied on a standard webhook subscription. For more information, see RFC 8291 Section 3.'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.thumbnailSet:
@@ -17575,7 +17633,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.thumbnail'
additionalProperties:
type: object
- description: The ThumbnailSet resource is a keyed collection of thumbnail resources.
microsoft.graph.driveItemVersion:
allOf:
- $ref: '#/components/schemas/microsoft.graph.baseItemVersion'
@@ -17902,6 +17959,29 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.plannerHistoryItem:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.plannerDelta'
+ - title: plannerHistoryItem
+ type: object
+ properties:
+ actor:
+ $ref: '#/components/schemas/microsoft.graph.identitySet'
+ entityId:
+ type: string
+ entityType:
+ $ref: '#/components/schemas/microsoft.graph.historyEntityType'
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.historyEventType'
+ occurredDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ planId:
+ type: string
+ additionalProperties:
+ type: object
microsoft.graph.plannerTask:
allOf:
- $ref: '#/components/schemas/microsoft.graph.plannerDelta'
@@ -19095,7 +19175,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -19111,13 +19191,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -19231,7 +19311,7 @@ components:
nullable: true
webUrl:
type: string
- description: Deep link URL of the tab instance. Read only.
+ description: Deep link URL of the tab instance. Read-only.
nullable: true
teamsApp:
$ref: '#/components/schemas/microsoft.graph.teamsApp'
@@ -20472,6 +20552,8 @@ components:
type: string
description: Name of the OS image that's on the Cloud PC.
nullable: true
+ isDisasterRecoveryActive:
+ type: boolean
lastLoginResult:
$ref: '#/components/schemas/microsoft.graph.cloudPcLoginResult'
lastModifiedDateTime:
@@ -21103,6 +21185,40 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.distributionList:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.outlookItem'
+ - title: distributionList
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The display name of the distribution list.
+ nullable: true
+ members:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.member'
+ description: The list of members in the distribution list. Not returned by default; use $select=members to include.
+ notes:
+ type: string
+ nullable: true
+ personIdentifier:
+ type: string
+ nullable: true
+ distributionListMembers:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.distributionListMember'
+ description: The expanded members of the distribution list. Each member contains detailed information including resolved email addresses. Read-only.
+ x-ms-navigationProperty: true
+ singleValueExtendedProperties:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
microsoft.graph.employeeExperienceUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -21124,7 +21240,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.storyline'
additionalProperties:
type: object
- description: Represents a container that exposes navigation properties for employee experience user resources.
microsoft.graph.inferenceClassification:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -22189,7 +22304,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -22228,6 +22342,11 @@ components:
- title: accessReviewInstance
type: object
properties:
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this review instance to the current reviewer. Null if the instance wasn't delegated. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
endDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -23431,28 +23550,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockInfo:
- title: lockInfo
- type: object
- properties:
- createdDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- expirationDateTime:
- pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
- type: string
- format: date-time
- nullable: true
- lockType:
- $ref: '#/components/schemas/microsoft.graph.lockType'
- owners:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.userIdentity'
- additionalProperties:
- type: object
microsoft.graph.folderView:
title: folderView
type: object
@@ -23471,6 +23568,30 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.lockType:
+ title: lockType
+ enum:
+ - none
+ - exclusive
+ - shared
+ - unknownFutureValue
+ type: string
+ microsoft.graph.userIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: userIdentity
+ type: object
+ properties:
+ ipAddress:
+ type: string
+ description: Indicates the client IP address associated with the user performing the activity (audit log only).
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: The userPrincipalName attribute of the user.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.mediaSource:
title: mediaSource
type: object
@@ -24010,6 +24131,22 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.historyEntityType:
+ title: historyEntityType
+ enum:
+ - task
+ - unknownFutureValue
+ type: string
+ microsoft.graph.historyEventType:
+ title: historyEventType
+ enum:
+ - created
+ - updated
+ - deleted
+ - undeleted
+ - moved
+ - unknownFutureValue
+ type: string
microsoft.graph.plannerAppliedCategories:
title: plannerAppliedCategories
type: object
@@ -26538,6 +26675,8 @@ components:
- modifyingSingleSignOn
- refreshPolicyConfiguration
- preparing
+ - failoverInProgress
+ - failbackInProgress
type: string
microsoft.graph.cloudPcStatusDetail:
title: cloudPcStatusDetail
@@ -26923,6 +27062,50 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.member:
+ title: member
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Optional.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Optional.
+ nullable: true
+ key:
+ type: string
+ description: The email address or routing key of the member. Required.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ routingType:
+ type: string
+ description: 'The routing type for the member, for example, SMTP. Optional.'
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.distributionListMember:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: distributionListMember
+ type: object
+ properties:
+ contactId:
+ type: string
+ description: 'The ID of the referenced contact, if applicable. Read-only.'
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the member. Read-only.
+ nullable: true
+ recipientType:
+ $ref: '#/components/schemas/microsoft.graph.recipientType'
+ contact:
+ $ref: '#/components/schemas/microsoft.graph.contact'
+ additionalProperties:
+ type: object
microsoft.graph.engagementRole:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -29164,6 +29347,8 @@ components:
type: string
description: Specifies the spoken language used during the meeting for recording and transcription purposes.
nullable: true
+ meetingType:
+ $ref: '#/components/schemas/microsoft.graph.onlineMeetingType'
recordAutomatically:
type: boolean
description: Indicates whether to record the meeting automatically.
@@ -29613,6 +29798,11 @@ components:
type: string
description: 'Result of the review. Possible values: Approve, Deny, NotReviewed, or DontKnow. Supports $select, $orderby, and $filter (eq only).'
nullable: true
+ delegatedBy:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.userIdentity'
+ description: The identities of users who delegated this decision item to the current reviewer. Null if the item wasn't delegated. A collection because multiple reviewers can delegate to the same user. Only returned via filterByCurrentUser when explicitly requested via $select. Read-only.
justification:
type: string
description: Justification left by the reviewer when they made the decision.
@@ -31018,30 +31208,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.lockType:
- title: lockType
- enum:
- - none
- - exclusive
- - shared
- - unknownFutureValue
- type: string
- microsoft.graph.userIdentity:
- allOf:
- - $ref: '#/components/schemas/microsoft.graph.identity'
- - title: userIdentity
- type: object
- properties:
- ipAddress:
- type: string
- description: Indicates the client IP address associated with the user performing the activity (audit log only).
- nullable: true
- userPrincipalName:
- type: string
- description: The userPrincipalName attribute of the user.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.mediaSourceContentCategory:
title: mediaSourceContentCategory
enum:
@@ -32036,7 +32202,7 @@ components:
nullable: true
defaultLabel:
type: string
- description: Label that would be used if no customizedLabel is provided. Read only.
+ description: Label that would be used if no customizedLabel is provided. Read-only.
nullable: true
fieldId:
type: string
@@ -32658,6 +32824,15 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipientType:
+ title: recipientType
+ enum:
+ - contact
+ - oneOff
+ - mailbox
+ - privateDL
+ - unknownFutureValue
+ type: string
microsoft.graph.engagementRoleMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -34188,12 +34363,15 @@ components:
properties:
moreInfoWebUrl:
type: string
+ description: Provides other video teleconferencing (VTC) dial-in options. Read-only.
nullable: true
tenantKey:
type: string
+ description: The tenant key that is used to dial into the interactive voice response (IVR) of the partner CVI service.
nullable: true
videoTeleconferenceId:
type: string
+ description: The video teleconferencing ID. Read-only.
nullable: true
additionalProperties:
type: object
@@ -34227,6 +34405,16 @@ components:
$ref: '#/components/schemas/microsoft.graph.lobbyBypassScope'
additionalProperties:
type: object
+ microsoft.graph.onlineMeetingType:
+ title: onlineMeetingType
+ enum:
+ - adhoc
+ - scheduled
+ - recurring
+ - broadcast
+ - meetnow
+ - unknownFutureValue
+ type: string
microsoft.graph.onlineMeetingSensitivityLabelAssignment:
title: onlineMeetingSensitivityLabelAssignment
type: object
@@ -35168,7 +35356,7 @@ components:
items:
type: string
nullable: true
- description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read only.'
+ description: 'The list of languages the user does not need translated. This is computed from the authoringLanguages collection in regionalAndLanguageSettings, and the languageOverrides collection in translationPreferences. The list specifies neutral culture values that include the language code without any country or region association. For example, it would specify ''fr'' for the neutral French culture, but not ''fr-FR'' for the French culture in France. Returned by default. Read-only.'
additionalProperties:
type: object
microsoft.graph.shiftAvailability:
@@ -35510,6 +35698,7 @@ components:
nullable: true
isRegistrationRequired:
type: boolean
+ description: Indicates whether attendee registration is enabled for the virtual event.
nullable: true
settings:
$ref: '#/components/schemas/microsoft.graph.virtualEventSettings'
@@ -37048,6 +37237,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.processContentMetadataBase'
description: 'A collection of content entries to be processed. Each entry contains the content itself and its metadata. Use conversation metadata for content like prompts and responses, file metadata for files, and content activity metadata for enforcement result status entries. Required.'
+ contextMetadata:
+ $ref: '#/components/schemas/microsoft.graph.contextMetadata'
deviceMetadata:
$ref: '#/components/schemas/microsoft.graph.deviceMetadata'
integratedAppMetadata:
@@ -40169,6 +40360,14 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.contextMetadata:
+ title: contextMetadata
+ type: object
+ properties:
+ metadataProperties:
+ $ref: '#/components/schemas/microsoft.graph.customMetadataDictionary'
+ additionalProperties:
+ type: object
microsoft.graph.deviceMetadata:
title: deviceMetadata
type: object
@@ -40696,16 +40895,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -40724,20 +40926,24 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions. Patterns must follow specific validation rules for standard URI formats or URN formats.
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -40756,16 +40962,19 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed globally across all platforms. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedDomainConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -40784,16 +40993,19 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed globally across all platforms. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme.
excludeActors:
$ref: '#/components/schemas/microsoft.graph.appManagementPolicyActorExemptions'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
publicClient:
$ref: '#/components/schemas/microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration'
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
spa:
@@ -40814,10 +41026,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.redirectUriWildcardExcludeFormats'
isStateSetByMicrosoft:
type: boolean
+ description: Indicates whether the restriction state was set by Microsoft.
readOnly: true
restrictForAppsCreatedAfterDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
+ description: Date and time when this restriction starts applying to newly created applications. Applications created before this date are not affected.
format: date-time
nullable: true
state:
@@ -40990,6 +41204,9 @@ components:
- downloadText
- downloadFile
- copyToClipboard
+ - pasteFromClipboard
+ - print
+ - accessDebugTools
- unknownFutureValue
type: string
microsoft.graph.contentBase:
@@ -41004,6 +41221,13 @@ components:
- ai
- unknownFutureValue
type: string
+ microsoft.graph.customMetadataDictionary:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.Dictionary'
+ - title: customMetadataDictionary
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.operatingSystemSpecifications:
title: operatingSystemSpecifications
type: object
@@ -41074,6 +41298,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are blocked for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformBlockedSchemeConfiguration:
@@ -41084,10 +41309,12 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are blocked for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1.
exemptFormats:
type: array
items:
type: string
+ description: Collection of URI patterns that are exempt from the blocked scheme restrictions for this platform. Patterns must follow specific validation rules for standard URI formats or URN formats.
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedDomainConfiguration:
@@ -41098,6 +41325,7 @@ components:
type: array
items:
type: string
+ description: 'Collection of domain names that are allowed for this specific platform. Domain validation follows RFC 3986 (URI syntax, section 3.2.2 for the host component). Domain matching is case-insensitive and exact; wildcards are not supported.'
additionalProperties:
type: object
microsoft.graph.redirectUriPlatformAllowedSchemeConfiguration:
@@ -41108,6 +41336,7 @@ components:
type: array
items:
type: string
+ description: Collection of URI schemes that are allowed for this specific platform. Schemes refer to URI schemes as defined in RFC 3986 §3.1. The value '*' can be used to allow any scheme for this platform.
additionalProperties:
type: object
microsoft.graph.redirectUriWildcardExcludeFormats:
@@ -41116,10 +41345,12 @@ components:
properties:
excludeWildcardsInPath:
type: boolean
+ description: 'When true, blocks the use of wildcards in the path portion of redirect URIs. When false, allows wildcards in paths.'
excludeWildcardsInPathWithDomains:
type: array
items:
type: string
+ description: 'Collection of domain names where wildcards in the path portion of redirect URIs are blocked. Accepts only valid host names (no wildcards) as defined in RFC 3986 §3.2.2. For example, login.microsoft.com or contoso.com.'
additionalProperties:
type: object
microsoft.graph.attributeMapping:
diff --git a/openApiDocs/v1.0/Applications.yml b/openApiDocs/v1.0/Applications.yml
index f8d816e7ce..52a6b946d6 100644
--- a/openApiDocs/v1.0/Applications.yml
+++ b/openApiDocs/v1.0/Applications.yml
@@ -3286,7 +3286,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action pause
- description: 'Temporarily stop a running synchronization job. All the progress, including job state, is persisted, and the job will continue from where it left off when a start call is made.'
+ description: 'Temporarily stop a running synchronizationJob. All the progress, including job state, is persisted, and the job will continue from where it left off when a start call is made.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-pause?view=graph-rest-1.0
@@ -3319,7 +3319,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action provisionOnDemand
- description: Select a user and provision the account on-demand. The rate limit for this API is 5 requests per 10 seconds.
+ description: Select a user and provision the account on-demand for a synchronizationJob. The rate limit for this API is 5 requests per 10 seconds.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-provisionondemand?view=graph-rest-1.0
@@ -3370,7 +3370,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action restart
- description: 'Restart a stopped synchronization job, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
+ description: 'Restart a stopped synchronizationJob, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-restart?view=graph-rest-1.0
@@ -3415,7 +3415,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action start
- description: 'Start an existing synchronization job. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
+ description: 'Start an existing synchronizationJob. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-start?view=graph-rest-1.0
@@ -3448,7 +3448,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action validateCredentials
- description: Validate that the credentials are valid in the tenant.
+ description: Validate that the credentials are valid in the tenant for a synchronizationJob.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-validatecredentials?view=graph-rest-1.0
@@ -3890,7 +3890,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: Discover the latest schema definition for provisioning to an application for the directoryDefinition.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-1.0
@@ -3965,7 +3965,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-1.0
@@ -4051,7 +4051,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-1.0
@@ -4137,7 +4137,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a given string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-1.0
@@ -4258,7 +4258,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action acquireAccessToken
- description: Acquire an OAuth access token to authorize the Microsoft Entra provisioning service to provision users into an application.
+ description: Acquire an OAuth access token from the synchronization resource to authorize the Microsoft Entra provisioning service to provision users into an application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-acquireaccesstoken?view=graph-rest-1.0
@@ -4508,7 +4508,7 @@ paths:
tags:
- applications.synchronization
summary: Update synchronizationTemplate
- description: Update (override) the synchronization template associated with a given application.
+ description: Update (override) the synchronizationTemplate associated with a given application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationtemplate-update?view=graph-rest-1.0
@@ -4971,7 +4971,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: Discover the latest schema definition for provisioning to an application for the directoryDefinition.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-1.0
@@ -5046,7 +5046,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-1.0
@@ -5132,7 +5132,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-1.0
@@ -5218,7 +5218,7 @@ paths:
tags:
- applications.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a given string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-1.0
@@ -12810,7 +12810,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: List synchronization jobs
- description: List existing jobs for a given application instance (service principal).
+ description: List existing synchronizationJob objects for a given application instance (service principal).
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-list-jobs?view=graph-rest-1.0
@@ -12872,7 +12872,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Create synchronizationJob
- description: Create new synchronization job with a default synchronization schema. The job is created in a disabled state. Call Start job to start synchronization.
+ description: Create a new synchronizationJob with a default synchronization schema. The job is created in a disabled state. Call Start job to start synchronization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-post-jobs?view=graph-rest-1.0
@@ -12908,7 +12908,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Get synchronizationJob
- description: Retrieve the existing synchronization job and its properties.
+ description: Retrieve an existing synchronizationJob and its properties.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-get?view=graph-rest-1.0
@@ -13003,7 +13003,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Delete synchronizationJob
- description: 'Stop the synchronization job, and permanently delete all the state associated with it. Synchronized accounts are left as-is.'
+ description: 'Stop the synchronizationJob, and permanently delete all the state associated with it. Synchronized accounts are left as-is.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-delete?view=graph-rest-1.0
@@ -13273,7 +13273,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action pause
- description: 'Temporarily stop a running synchronization job. All the progress, including job state, is persisted, and the job will continue from where it left off when a start call is made.'
+ description: 'Temporarily stop a running synchronizationJob. All the progress, including job state, is persisted, and the job will continue from where it left off when a start call is made.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-pause?view=graph-rest-1.0
@@ -13306,7 +13306,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action provisionOnDemand
- description: Select a user and provision the account on-demand. The rate limit for this API is 5 requests per 10 seconds.
+ description: Select a user and provision the account on-demand for a synchronizationJob. The rate limit for this API is 5 requests per 10 seconds.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-provisionondemand?view=graph-rest-1.0
@@ -13357,7 +13357,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action restart
- description: 'Restart a stopped synchronization job, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
+ description: 'Restart a stopped synchronizationJob, forcing it to reprocess all the objects in the directory. Optionally clears existing the synchronization state and previous errors.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-restart?view=graph-rest-1.0
@@ -13402,7 +13402,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action start
- description: 'Start an existing synchronization job. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
+ description: 'Start an existing synchronizationJob. If the job is in a paused state, it continues processing changes from the point where it was paused. If the job is in quarantine, the quarantine status is cleared. Don''t create scripts to call the start job continuously while it''s running because that can cause the service to stop running. Use the start job only when the job is currently paused or in quarantine. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-start?view=graph-rest-1.0
@@ -13435,7 +13435,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action validateCredentials
- description: Validate that the credentials are valid in the tenant.
+ description: Validate that the credentials are valid in the tenant for a synchronizationJob.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationjob-validatecredentials?view=graph-rest-1.0
@@ -13492,7 +13492,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Get synchronizationSchema
- description: Retrieve the schema for a given synchronization job or template.
+ description: Retrieve the synchronizationSchema for a given synchronization job or template.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-get?view=graph-rest-1.0
@@ -13548,7 +13548,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Update synchronizationSchema
- description: 'Update the synchronization schema for a given job or template. This method fully replaces the current schema with the one provided in the request. To update the schema of a template, make the call on the application object. You must be the owner of the application.'
+ description: 'Update the synchronizationSchema for a given job or template. This method fully replaces the current schema with the one provided in the request. To update the schema of a template, make the call on the application object. You must be the owner of the application.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-update?view=graph-rest-1.0
@@ -13884,7 +13884,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: Discover the latest schema definition for provisioning to an application for the directoryDefinition.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-1.0
@@ -13959,7 +13959,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-1.0
@@ -14045,7 +14045,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-1.0
@@ -14131,7 +14131,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a given string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-1.0
@@ -14252,7 +14252,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action acquireAccessToken
- description: Acquire an OAuth access token to authorize the Microsoft Entra provisioning service to provision users into an application.
+ description: Acquire an OAuth access token from the synchronization resource to authorize the Microsoft Entra provisioning service to provision users into an application.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-acquireaccesstoken?view=graph-rest-1.0
@@ -14291,7 +14291,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Add synchronization secrets
- description: Provide credentials for establishing connectivity with the target system.
+ description: Provide credentials for establishing connectivity with the target system and store them in the synchronization resource.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-serviceprincipal-put-synchronization?view=graph-rest-1.0
@@ -14362,7 +14362,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: List existing synchronization templates
- description: List the synchronization templates associated with a given application or service principal.
+ description: List synchronizationTemplate objects associated with a given application or service principal.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronization-list-templates?view=graph-rest-1.0
@@ -14968,7 +14968,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action discover
- description: 'Discover the latest schema definition for provisioning to an application. '
+ description: Discover the latest schema definition for provisioning to an application for the directoryDefinition.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-directorydefinition-discover?view=graph-rest-1.0
@@ -15043,7 +15043,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function filterOperators
- description: List all operators supported in the scoping filters.
+ description: List all operators supported in the scoping filters for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-filteroperators?view=graph-rest-1.0
@@ -15129,7 +15129,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke function functions
- description: List all the functions currently supported in the attributeMappingSource.
+ description: List all the functions currently supported in the attributeMappingSource for a synchronizationSchema.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-functions?view=graph-rest-1.0
@@ -15215,7 +15215,7 @@ paths:
tags:
- servicePrincipals.synchronization
summary: Invoke action parseExpression
- description: 'Parse a given string expression into an attributeMappingSource object. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
+ description: 'Parse a given string expression into an attributeMappingSource object for a synchronizationSchema. For more information about expressions, see Writing Expressions for Attribute Mappings in Microsoft Entra ID.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/synchronization-synchronizationschema-parseexpression?view=graph-rest-1.0
@@ -17290,6 +17290,7 @@ components:
subject:
type: string
description: 'Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format; each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the sub claim within the token presented to Microsoft Entra ID. The combination of issuer and subject must be unique within the app. It has a limit of 600 characters. Supports $filter (eq).'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.homeRealmDiscoveryPolicy:
@@ -17716,7 +17717,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -17743,7 +17744,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -17890,7 +17891,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -17912,7 +17913,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -17945,7 +17946,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -18043,7 +18044,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -18300,7 +18301,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.synchronization:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -18796,7 +18796,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -18818,6 +18818,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -18826,7 +18828,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -18889,6 +18891,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -18923,6 +18929,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -19000,11 +19008,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -19151,7 +19173,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.selfSignedCertificate:
title: selfSignedCertificate
type: object
@@ -22009,7 +22030,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -22776,6 +22796,15 @@ components:
- high
- unknownFutureValue
type: string
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -23498,6 +23527,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -24367,7 +24397,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -24383,13 +24413,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -24853,6 +24883,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -25439,7 +25474,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -25608,7 +25643,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -29727,6 +29762,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/openApiDocs/v1.0/BackupRestore.yml b/openApiDocs/v1.0/BackupRestore.yml
index 98d57e843d..22cd9b5b70 100644
--- a/openApiDocs/v1.0/BackupRestore.yml
+++ b/openApiDocs/v1.0/BackupRestore.yml
@@ -960,6 +960,91 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /solutions/backupRestore/emailNotificationsSetting:
+ get:
+ tags:
+ - solutions.backupRestoreRoot
+ summary: Get emailNotificationsSetting
+ description: Read the properties and relationships of an emailNotificationsSetting object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/emailnotificationssetting-get?view=graph-rest-1.0
+ operationId: solution.backupRestore_GetEmailNotificationsSetting
+ parameters:
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.emailNotificationsSetting'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - solutions.backupRestoreRoot
+ summary: Update emailNotificationsSetting
+ description: Update the properties of an emailNotificationsSetting object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/emailnotificationssetting-update?view=graph-rest-1.0
+ operationId: solution.backupRestore_UpdateEmailNotificationsSetting
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.emailNotificationsSetting'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.emailNotificationsSetting'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - solutions.backupRestoreRoot
+ summary: Delete navigation property emailNotificationsSetting for solutions
+ operationId: solution.backupRestore_DeleteEmailNotificationsSetting
+ parameters:
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
/solutions/backupRestore/exchangeProtectionPolicies:
get:
tags:
@@ -9024,6 +9109,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.driveProtectionUnitsBulkAdditionJob'
x-ms-navigationProperty: true
+ emailNotificationsSetting:
+ $ref: '#/components/schemas/microsoft.graph.emailNotificationsSetting'
exchangeProtectionPolicies:
type: array
items:
@@ -9278,6 +9365,21 @@ components:
description: The list of email addresses to add to the OneDrive protection policy.
additionalProperties:
type: object
+ microsoft.graph.emailNotificationsSetting:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: emailNotificationsSetting
+ type: object
+ properties:
+ additionalEvents:
+ $ref: '#/components/schemas/microsoft.graph.notificationEventsType'
+ isEnabled:
+ type: boolean
+ description: Indicates whether notifications are enabled.
+ recipients:
+ $ref: '#/components/schemas/microsoft.graph.notificationRecipients'
+ additionalProperties:
+ type: object
microsoft.graph.exchangeProtectionPolicy:
allOf:
- $ref: '#/components/schemas/microsoft.graph.protectionPolicyBase'
@@ -10120,6 +10222,28 @@ components:
$ref: '#/components/schemas/microsoft.graph.protectionUnitsBulkJobStatus'
additionalProperties:
type: object
+ microsoft.graph.notificationEventsType:
+ title: notificationEventsType
+ enum:
+ - none
+ - restoreAndPolicyUpdates
+ - unknownFutureValue
+ type: string
+ x-ms-enum-flags:
+ isFlags: true
+ microsoft.graph.notificationRecipients:
+ title: notificationRecipients
+ type: object
+ properties:
+ customRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.emailIdentity'
+ description: A list of users or groups that receive notifications. Only specify this property when role is set to custom.
+ role:
+ $ref: '#/components/schemas/microsoft.graph.notificationRecipientsType'
+ additionalProperties:
+ type: object
microsoft.graph.restoreArtifactBase:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -10943,6 +11067,30 @@ components:
- completedWithErrors
- unknownFutureValue
type: string
+ microsoft.graph.emailIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: emailIdentity
+ type: object
+ properties:
+ email:
+ type: string
+ description: Email address of the user.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.notificationRecipientsType:
+ title: notificationRecipientsType
+ enum:
+ - none
+ - globalAdmins
+ - backupAdmins
+ - custom
+ - allAdmins
+ - unknownFutureValue
+ type: string
+ x-ms-enum-flags:
+ isFlags: true
microsoft.graph.destinationType:
title: destinationType
enum:
diff --git a/openApiDocs/v1.0/Bookings.yml b/openApiDocs/v1.0/Bookings.yml
index 8f5c6e7fcf..2bf69c0e14 100644
--- a/openApiDocs/v1.0/Bookings.yml
+++ b/openApiDocs/v1.0/Bookings.yml
@@ -70,7 +70,7 @@ paths:
tags:
- solutions.bookingBusiness
summary: List bookingBusinesses
- description: 'Get a collection of bookingBusiness objects that has been created for the tenant. This operation returns only the id and displayName of each Microsoft Bookings business in the collection. For performance considerations, it does not return other properties. You can get the other properties of a Bookings business by specifying its id in a GET operation.'
+ description: 'Get a collection of bookingBusiness objects that has been created for the tenant. This operation returns only the id and displayName of each Microsoft Bookings business in the collection. For performance considerations, it doesn''t return other properties. You can get the other properties of a Bookings business by specifying its id in a GET operation.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/bookingbusiness-list?view=graph-rest-1.0
@@ -8607,6 +8607,8 @@ components:
items:
$ref: '#/components/schemas/microsoft.graph.driveProtectionUnitsBulkAdditionJob'
x-ms-navigationProperty: true
+ emailNotificationsSetting:
+ $ref: '#/components/schemas/microsoft.graph.emailNotificationsSetting'
exchangeProtectionPolicies:
type: array
items:
@@ -9680,6 +9682,21 @@ components:
description: The list of email addresses to add to the OneDrive protection policy.
additionalProperties:
type: object
+ microsoft.graph.emailNotificationsSetting:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: emailNotificationsSetting
+ type: object
+ properties:
+ additionalEvents:
+ $ref: '#/components/schemas/microsoft.graph.notificationEventsType'
+ isEnabled:
+ type: boolean
+ description: Indicates whether notifications are enabled.
+ recipients:
+ $ref: '#/components/schemas/microsoft.graph.notificationRecipients'
+ additionalProperties:
+ type: object
microsoft.graph.exchangeProtectionPolicy:
allOf:
- $ref: '#/components/schemas/microsoft.graph.protectionPolicyBase'
@@ -10600,6 +10617,28 @@ components:
$ref: '#/components/schemas/microsoft.graph.protectionUnitsBulkJobStatus'
additionalProperties:
type: object
+ microsoft.graph.notificationEventsType:
+ title: notificationEventsType
+ enum:
+ - none
+ - restoreAndPolicyUpdates
+ - unknownFutureValue
+ type: string
+ x-ms-enum-flags:
+ isFlags: true
+ microsoft.graph.notificationRecipients:
+ title: notificationRecipients
+ type: object
+ properties:
+ customRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.emailIdentity'
+ description: A list of users or groups that receive notifications. Only specify this property when role is set to custom.
+ role:
+ $ref: '#/components/schemas/microsoft.graph.notificationRecipientsType'
+ additionalProperties:
+ type: object
microsoft.graph.granularMailboxRestoreArtifact:
allOf:
- $ref: '#/components/schemas/microsoft.graph.mailboxRestoreArtifact'
@@ -11019,6 +11058,30 @@ components:
- completedWithErrors
- unknownFutureValue
type: string
+ microsoft.graph.emailIdentity:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.identity'
+ - title: emailIdentity
+ type: object
+ properties:
+ email:
+ type: string
+ description: Email address of the user.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.notificationRecipientsType:
+ title: notificationRecipientsType
+ enum:
+ - none
+ - globalAdmins
+ - backupAdmins
+ - custom
+ - allAdmins
+ - unknownFutureValue
+ type: string
+ x-ms-enum-flags:
+ isFlags: true
microsoft.graph.restoreArtifactBase:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
diff --git a/openApiDocs/v1.0/Calendar.yml b/openApiDocs/v1.0/Calendar.yml
index 420583ee3b..7103e6e3a0 100644
--- a/openApiDocs/v1.0/Calendar.yml
+++ b/openApiDocs/v1.0/Calendar.yml
@@ -19493,6 +19493,10 @@ components:
type: string
description: The phone number of the place.
nullable: true
+ placeId:
+ type: string
+ description: A stable service-level identifier for the place object used by Places workloads.
+ nullable: true
tags:
type: array
items:
@@ -19653,6 +19657,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.mailboxDetails'
mode:
$ref: '#/components/schemas/microsoft.graph.placeMode'
+ servicePlans:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.placeServicePlanInfo'
+ description: The service plans associated with the desk.
additionalProperties:
type: object
microsoft.graph.floor:
@@ -19715,10 +19724,6 @@ components:
nickname:
type: string
description: 'Specifies a nickname for the room, for example, ''conf room''.'
- placeId:
- type: string
- description: An alternative immutable unique identifier of the room. Read-only.
- nullable: true
teamsEnabledState:
$ref: '#/components/schemas/microsoft.graph.placeFeatureEnablement'
videoDeviceName:
@@ -19775,10 +19780,6 @@ components:
nickname:
type: string
description: 'A short, friendly name for the workspace, often used for easier identification or display in the UI.'
- placeId:
- type: string
- description: An alternative immutable unique identifier of the workspace. Read-only.
- nullable: true
additionalProperties:
type: object
microsoft.graph.section:
@@ -20253,6 +20254,16 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.placeServicePlanInfo:
+ title: placeServicePlanInfo
+ type: object
+ properties:
+ servicePlanId:
+ type: string
+ description: The service plan identifier.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.bookingType:
title: bookingType
enum:
diff --git a/openApiDocs/v1.0/CloudCommunications.yml b/openApiDocs/v1.0/CloudCommunications.yml
index 7107092ad4..5447f32c86 100644
--- a/openApiDocs/v1.0/CloudCommunications.yml
+++ b/openApiDocs/v1.0/CloudCommunications.yml
@@ -3339,7 +3339,7 @@ paths:
tags:
- communications.call
summary: Invoke action keepAlive
- description: 'Make a request to this API every 15 to 45 minutes to ensure that an ongoing call remains active. A call that does not receive this request within 45 minutes is considered inactive and will subsequently end. At least one successful request must be made within 45 minutes of the previous request, or the start of the call. We recommend that you send a request in shorter time intervals (every 15 minutes). Make sure that these requests are successful to prevent the call from timing out and ending. Attempting to send a request to a call that has already ended will result in a 404 Not-Found error. The resources related to the call should be cleaned up on the application side.'
+ description: 'Make a request to this API every 15 to 45 minutes to ensure that an ongoing call remains active. A call that doesn''t receive this request within 45 minutes is considered inactive and will subsequently end. At least one successful request must be made within 45 minutes of the previous request, or the start of the call. We recommend that you send a request in shorter time intervals (every 15 minutes). Make sure that these requests are successful to prevent the call from timing out and ending. Attempting to send a request to a call that has already ended will result in a 404 Not-Found error. The resources related to the call should be cleaned up on the application side.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/call-keepalive?view=graph-rest-1.0
@@ -3577,7 +3577,7 @@ paths:
tags:
- communications.call
summary: Invoke action reject
- description: 'Enable a bot to reject an incoming call. The incoming call request can be an invite from a participant in a group call or a peer-to-peer call. If an invite to a group call is received, the notification will contain the chatInfo and meetingInfo parameters. The bot is expected to answer or reject the call before the call times out. The current timeout value is 15 seconds. This API does not end existing calls that have already been answered. Use delete call to end a call.'
+ description: 'Enable a bot to reject an incoming call. The incoming call request can be an invite from a participant in a group call or a peer-to-peer call. If an invite to a group call is received, the notification will contain the chatInfo and meetingInfo parameters. The bot is expected to answer or reject the call before the call times out. The current timeout value is 15 seconds. This API doesn''t end existing calls that have already been answered. Use delete call to end a call.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/call-reject?view=graph-rest-1.0
@@ -11685,7 +11685,7 @@ paths:
tags:
- users.onlineMeeting
summary: List transcripts
- description: Retrieve the list of callTranscript objects associated with a scheduled onlineMeeting. This API supports the retrieval of call transcripts from all meeting types except live events.
+ description: 'Retrieve the list of callTranscript objects associated with a scheduled onlineMeeting. This API supports the retrieval of call transcripts from all meeting types except live events. Access to this API is governed by tenant administrator settings. For more information, see Error responses.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/onlinemeeting-list-transcripts?view=graph-rest-1.0
@@ -13970,7 +13970,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.meetingAttendanceReport:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
diff --git a/openApiDocs/v1.0/Compliance.yml b/openApiDocs/v1.0/Compliance.yml
index 9750ea3e85..c684bccc4d 100644
--- a/openApiDocs/v1.0/Compliance.yml
+++ b/openApiDocs/v1.0/Compliance.yml
@@ -1712,7 +1712,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -1739,7 +1739,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -1886,7 +1886,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -1908,7 +1908,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -1941,7 +1941,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -2039,7 +2039,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -2296,7 +2296,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -4848,7 +4847,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -5391,7 +5389,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -5481,6 +5479,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -5489,7 +5489,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -5552,6 +5552,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -5586,6 +5590,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -5663,11 +5669,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -5814,7 +5834,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAppInstallation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -5938,7 +5957,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -6216,6 +6235,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -7035,7 +7055,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -7051,13 +7071,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -7509,6 +7529,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -9887,6 +9912,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -11815,6 +11849,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/openApiDocs/v1.0/ConfigurationManagement.yml b/openApiDocs/v1.0/ConfigurationManagement.yml
index 48be2b20d7..5eb013c91f 100644
--- a/openApiDocs/v1.0/ConfigurationManagement.yml
+++ b/openApiDocs/v1.0/ConfigurationManagement.yml
@@ -1682,6 +1682,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.Dictionary:
title: Dictionary
type: object
diff --git a/openApiDocs/v1.0/CrossDeviceExperiences.yml b/openApiDocs/v1.0/CrossDeviceExperiences.yml
index 4829270c51..d3c154f50d 100644
--- a/openApiDocs/v1.0/CrossDeviceExperiences.yml
+++ b/openApiDocs/v1.0/CrossDeviceExperiences.yml
@@ -805,6 +805,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
diff --git a/openApiDocs/v1.0/DeviceManagement.Administration.yml b/openApiDocs/v1.0/DeviceManagement.Administration.yml
index 7c2e73894e..bf9fad2edc 100644
--- a/openApiDocs/v1.0/DeviceManagement.Administration.yml
+++ b/openApiDocs/v1.0/DeviceManagement.Administration.yml
@@ -5845,6 +5845,121 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ /deviceManagement/virtualEndpoint/servicePlans:
+ get:
+ tags:
+ - deviceManagement.virtualEndpoint
+ summary: List servicePlans
+ description: 'List the currently available service plans that an organization can purchase for their Cloud PCs. For examples of currently available service plans, see Windows 365 compare plans and pricing. Currently, the Microsoft Graph API is available for Windows 365 Enterprise.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/virtualendpoint-list-serviceplans?view=graph-rest-1.0
+ operationId: deviceManagement.virtualEndpoint_ListServicePlan
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.cloudPcServicePlanCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/deviceManagement/virtualEndpoint/servicePlans/{cloudPcServicePlan-id}':
+ get:
+ tags:
+ - deviceManagement.virtualEndpoint
+ summary: Get servicePlans from deviceManagement
+ description: A collection of Cloud PC service plans.
+ operationId: deviceManagement.virtualEndpoint_GetServicePlan
+ parameters:
+ - name: cloudPcServicePlan-id
+ in: path
+ description: The unique identifier of cloudPcServicePlan
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: cloudPcServicePlan
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcServicePlan'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /deviceManagement/virtualEndpoint/servicePlans/$count:
+ get:
+ tags:
+ - deviceManagement.virtualEndpoint
+ summary: Get the number of the resource
+ operationId: deviceManagement.virtualEndpoint.servicePlan_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
/deviceManagement/virtualEndpoint/userSettings:
get:
tags:
@@ -6946,6 +7061,12 @@ components:
x-ms-navigationProperty: true
report:
$ref: '#/components/schemas/microsoft.graph.cloudPcReport'
+ servicePlans:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcServicePlan'
+ description: A collection of Cloud PC service plans.
+ x-ms-navigationProperty: true
userSettings:
type: array
items:
@@ -7399,7 +7520,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -7426,7 +7547,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -7573,7 +7694,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -7595,7 +7716,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -7628,7 +7749,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -7726,7 +7847,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -7983,7 +8104,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -8029,6 +8149,35 @@ components:
- cloudPcUsageCategoryReport
- unknownFutureValue
type: string
+ microsoft.graph.cloudPcServicePlan:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: cloudPcServicePlan
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The name for the service plan. Read-only.
+ ramInGB:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The size of the RAM in GB. Read-only.
+ format: int32
+ storageInGB:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The size of the operating system disk in GB. Read-only.
+ format: int32
+ vCpuCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The number of vCPUs. Read-only.
+ format: int32
+ additionalProperties:
+ type: object
microsoft.graph.cloudPcUserSetting:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -10898,7 +11047,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -11606,6 +11754,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.cloudPcServicePlanCollectionResponse:
+ title: Collection of cloudPcServicePlan
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcServicePlan'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.cloudPcUserSettingCollectionResponse:
title: Collection of cloudPcUserSetting
type: object
@@ -11812,6 +11973,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -12681,7 +12843,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -12697,13 +12859,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -13160,6 +13322,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -13771,7 +13938,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -13861,6 +14028,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -13869,7 +14038,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -13932,6 +14101,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -13966,6 +14139,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -14043,11 +14218,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -14194,7 +14383,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -14280,7 +14468,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -17775,6 +17963,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -18736,6 +18929,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -25597,6 +25799,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceProvisioningErrorCollectionResponse'
+ microsoft.graph.cloudPcServicePlanCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcServicePlanCollectionResponse'
microsoft.graph.cloudPcUserSettingCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/v1.0/DeviceManagement.yml b/openApiDocs/v1.0/DeviceManagement.yml
index b441d72e00..84acc406ce 100644
--- a/openApiDocs/v1.0/DeviceManagement.yml
+++ b/openApiDocs/v1.0/DeviceManagement.yml
@@ -13947,6 +13947,12 @@ components:
x-ms-navigationProperty: true
report:
$ref: '#/components/schemas/microsoft.graph.cloudPcReport'
+ servicePlans:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.cloudPcServicePlan'
+ description: A collection of Cloud PC service plans.
+ x-ms-navigationProperty: true
userSettings:
type: array
items:
@@ -14716,7 +14722,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -14743,7 +14749,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -14890,7 +14896,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -14912,7 +14918,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -14945,7 +14951,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -15043,7 +15049,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -15300,7 +15306,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.deviceAndAppManagementAssignmentTarget:
title: deviceAndAppManagementAssignmentTarget
type: object
@@ -18004,6 +18009,35 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.cloudPcServicePlan:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: cloudPcServicePlan
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: The name for the service plan. Read-only.
+ ramInGB:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The size of the RAM in GB. Read-only.
+ format: int32
+ storageInGB:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The size of the operating system disk in GB. Read-only.
+ format: int32
+ vCpuCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: The number of vCPUs. Read-only.
+ format: int32
+ additionalProperties:
+ type: object
microsoft.graph.cloudPcUserSetting:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -20107,7 +20141,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -21040,6 +21073,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -21909,7 +21943,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -21925,13 +21959,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -22376,6 +22410,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -22987,7 +23026,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -23077,6 +23116,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -23085,7 +23126,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -23148,6 +23189,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -23182,6 +23227,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -23259,11 +23306,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -23410,7 +23471,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23496,7 +23556,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -26168,6 +26228,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -27129,6 +27194,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
diff --git a/openApiDocs/v1.0/Devices.CloudPrint.yml b/openApiDocs/v1.0/Devices.CloudPrint.yml
index 4114ef50f3..feb3317556 100644
--- a/openApiDocs/v1.0/Devices.CloudPrint.yml
+++ b/openApiDocs/v1.0/Devices.CloudPrint.yml
@@ -6881,6 +6881,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -6889,7 +6891,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -6952,6 +6954,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -6986,6 +6992,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -7063,11 +7071,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -7214,7 +7236,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.user:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
@@ -7227,7 +7248,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -7254,7 +7275,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -7401,7 +7422,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -7423,7 +7444,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -7456,7 +7477,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -7554,7 +7575,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -7811,7 +7832,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.automaticRepliesSetting:
title: automaticRepliesSetting
type: object
@@ -8409,6 +8429,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -8451,6 +8480,72 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.onPremisesExtensionAttributes:
+ title: onPremisesExtensionAttributes
+ type: object
+ properties:
+ extensionAttribute1:
+ type: string
+ description: First customizable extension attribute.
+ nullable: true
+ extensionAttribute10:
+ type: string
+ description: Tenth customizable extension attribute.
+ nullable: true
+ extensionAttribute11:
+ type: string
+ description: Eleventh customizable extension attribute.
+ nullable: true
+ extensionAttribute12:
+ type: string
+ description: Twelfth customizable extension attribute.
+ nullable: true
+ extensionAttribute13:
+ type: string
+ description: Thirteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute14:
+ type: string
+ description: Fourteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute15:
+ type: string
+ description: Fifteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute2:
+ type: string
+ description: Second customizable extension attribute.
+ nullable: true
+ extensionAttribute3:
+ type: string
+ description: Third customizable extension attribute.
+ nullable: true
+ extensionAttribute4:
+ type: string
+ description: Fourth customizable extension attribute.
+ nullable: true
+ extensionAttribute5:
+ type: string
+ description: Fifth customizable extension attribute.
+ nullable: true
+ extensionAttribute6:
+ type: string
+ description: Sixth customizable extension attribute.
+ nullable: true
+ extensionAttribute7:
+ type: string
+ description: Seventh customizable extension attribute.
+ nullable: true
+ extensionAttribute8:
+ type: string
+ description: Eighth customizable extension attribute.
+ nullable: true
+ extensionAttribute9:
+ type: string
+ description: Ninth customizable extension attribute.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
@@ -9421,72 +9516,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.onPremisesExtensionAttributes:
- title: onPremisesExtensionAttributes
- type: object
- properties:
- extensionAttribute1:
- type: string
- description: First customizable extension attribute.
- nullable: true
- extensionAttribute10:
- type: string
- description: Tenth customizable extension attribute.
- nullable: true
- extensionAttribute11:
- type: string
- description: Eleventh customizable extension attribute.
- nullable: true
- extensionAttribute12:
- type: string
- description: Twelfth customizable extension attribute.
- nullable: true
- extensionAttribute13:
- type: string
- description: Thirteenth customizable extension attribute.
- nullable: true
- extensionAttribute14:
- type: string
- description: Fourteenth customizable extension attribute.
- nullable: true
- extensionAttribute15:
- type: string
- description: Fifteenth customizable extension attribute.
- nullable: true
- extensionAttribute2:
- type: string
- description: Second customizable extension attribute.
- nullable: true
- extensionAttribute3:
- type: string
- description: Third customizable extension attribute.
- nullable: true
- extensionAttribute4:
- type: string
- description: Fourth customizable extension attribute.
- nullable: true
- extensionAttribute5:
- type: string
- description: Fifth customizable extension attribute.
- nullable: true
- extensionAttribute6:
- type: string
- description: Sixth customizable extension attribute.
- nullable: true
- extensionAttribute7:
- type: string
- description: Seventh customizable extension attribute.
- nullable: true
- extensionAttribute8:
- type: string
- description: Eighth customizable extension attribute.
- nullable: true
- extensionAttribute9:
- type: string
- description: Ninth customizable extension attribute.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.passwordProfile:
title: passwordProfile
type: object
@@ -10944,7 +10973,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -12681,6 +12709,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -13448,7 +13481,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -13655,7 +13688,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -13839,6 +13872,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -14356,7 +14390,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -14372,13 +14406,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -16967,6 +17001,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/openApiDocs/v1.0/Devices.CorporateManagement.yml b/openApiDocs/v1.0/Devices.CorporateManagement.yml
index 0704b31e0c..cfbb9c91fa 100644
--- a/openApiDocs/v1.0/Devices.CorporateManagement.yml
+++ b/openApiDocs/v1.0/Devices.CorporateManagement.yml
@@ -34817,7 +34817,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -34844,7 +34844,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -34991,7 +34991,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -35013,7 +35013,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -35046,7 +35046,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -35144,7 +35144,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -35401,7 +35401,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.policyPlatformType:
title: policyPlatformType
enum:
@@ -39199,7 +39198,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -39676,6 +39674,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -40545,7 +40544,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -40561,13 +40560,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -41031,6 +41030,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -41642,7 +41646,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -41732,6 +41736,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -41740,7 +41746,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -41803,6 +41809,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -41837,6 +41847,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -41914,11 +41926,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -42065,7 +42091,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -42151,7 +42176,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -44637,6 +44662,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -45598,6 +45628,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
diff --git a/openApiDocs/v1.0/Devices.ServiceAnnouncement.yml b/openApiDocs/v1.0/Devices.ServiceAnnouncement.yml
index 0033694291..e088719c6a 100644
--- a/openApiDocs/v1.0/Devices.ServiceAnnouncement.yml
+++ b/openApiDocs/v1.0/Devices.ServiceAnnouncement.yml
@@ -490,7 +490,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Invoke function incidentReport
- description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
+ description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document doesn't exist for the issue.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-incidentreport?view=graph-rest-1.0
@@ -647,7 +647,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Get serviceHealthIssue
- description: Retrieve the properties and relationships of a serviceHealthIssue object. This operation retrieves a specified service health issue for tenant. The operation returns an error if the issue does not exist for the tenant.
+ description: Retrieve the properties and relationships of a serviceHealthIssue object. This operation retrieves a specified service health issue for tenant. The operation returns an error if the issue doesn't exist for the tenant.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-get?view=graph-rest-1.0
@@ -753,7 +753,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Invoke function incidentReport
- description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document does not exist for the issue.
+ description: Provide the Post-Incident Review (PIR) document of a specified service issue for tenant. An issue only with status of PostIncidentReviewPublished indicates that the PIR document exists for the issue. The operation returns an error if the specified issue doesn't exist for the tenant or if PIR document doesn't exist for the issue.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/servicehealthissue-incidentreport?view=graph-rest-1.0
@@ -880,7 +880,7 @@ paths:
tags:
- admin.serviceAnnouncement
summary: Get serviceUpdateMessage
- description: Retrieve the properties and relationships of a serviceUpdateMessage object. This operation retrieves a specified service update message for the tenant. The operation returns an error if the message does not exist for the tenant.
+ description: Retrieve the properties and relationships of a serviceUpdateMessage object. This operation retrieves a specified service update message for the tenant. The operation returns an error if the message doesn't exist for the tenant.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/serviceupdatemessage-get?view=graph-rest-1.0
@@ -1699,19 +1699,19 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceHealth'
- description: 'A collection of service health information for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service health information for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
issues:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceHealthIssue'
- description: 'A collection of service issues for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service issues for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
messages:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
- description: 'A collection of service messages for tenant. This property is a contained navigation property, it is nullable and readonly.'
+ description: 'A collection of service messages for tenant. This property is a contained navigation property, it is nullable and read-only.'
x-ms-navigationProperty: true
additionalProperties:
type: object
diff --git a/openApiDocs/v1.0/Education.yml b/openApiDocs/v1.0/Education.yml
index 6135188ce0..70cf3fb992 100644
--- a/openApiDocs/v1.0/Education.yml
+++ b/openApiDocs/v1.0/Education.yml
@@ -19120,6 +19120,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -19128,7 +19130,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -19191,6 +19193,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -19225,6 +19231,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -19302,11 +19310,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -19453,7 +19475,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.educationModule:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -19745,7 +19766,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -19772,7 +19793,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -19919,7 +19940,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -19941,7 +19962,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -19974,7 +19995,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -20072,7 +20093,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -20329,7 +20350,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -20976,6 +20996,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -21018,6 +21047,72 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.onPremisesExtensionAttributes:
+ title: onPremisesExtensionAttributes
+ type: object
+ properties:
+ extensionAttribute1:
+ type: string
+ description: First customizable extension attribute.
+ nullable: true
+ extensionAttribute10:
+ type: string
+ description: Tenth customizable extension attribute.
+ nullable: true
+ extensionAttribute11:
+ type: string
+ description: Eleventh customizable extension attribute.
+ nullable: true
+ extensionAttribute12:
+ type: string
+ description: Twelfth customizable extension attribute.
+ nullable: true
+ extensionAttribute13:
+ type: string
+ description: Thirteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute14:
+ type: string
+ description: Fourteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute15:
+ type: string
+ description: Fifteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute2:
+ type: string
+ description: Second customizable extension attribute.
+ nullable: true
+ extensionAttribute3:
+ type: string
+ description: Third customizable extension attribute.
+ nullable: true
+ extensionAttribute4:
+ type: string
+ description: Fourth customizable extension attribute.
+ nullable: true
+ extensionAttribute5:
+ type: string
+ description: Fifth customizable extension attribute.
+ nullable: true
+ extensionAttribute6:
+ type: string
+ description: Sixth customizable extension attribute.
+ nullable: true
+ extensionAttribute7:
+ type: string
+ description: Seventh customizable extension attribute.
+ nullable: true
+ extensionAttribute8:
+ type: string
+ description: Eighth customizable extension attribute.
+ nullable: true
+ extensionAttribute9:
+ type: string
+ description: Ninth customizable extension attribute.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
@@ -22162,72 +22257,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.onPremisesExtensionAttributes:
- title: onPremisesExtensionAttributes
- type: object
- properties:
- extensionAttribute1:
- type: string
- description: First customizable extension attribute.
- nullable: true
- extensionAttribute10:
- type: string
- description: Tenth customizable extension attribute.
- nullable: true
- extensionAttribute11:
- type: string
- description: Eleventh customizable extension attribute.
- nullable: true
- extensionAttribute12:
- type: string
- description: Twelfth customizable extension attribute.
- nullable: true
- extensionAttribute13:
- type: string
- description: Thirteenth customizable extension attribute.
- nullable: true
- extensionAttribute14:
- type: string
- description: Fourteenth customizable extension attribute.
- nullable: true
- extensionAttribute15:
- type: string
- description: Fifteenth customizable extension attribute.
- nullable: true
- extensionAttribute2:
- type: string
- description: Second customizable extension attribute.
- nullable: true
- extensionAttribute3:
- type: string
- description: Third customizable extension attribute.
- nullable: true
- extensionAttribute4:
- type: string
- description: Fourth customizable extension attribute.
- nullable: true
- extensionAttribute5:
- type: string
- description: Fifth customizable extension attribute.
- nullable: true
- extensionAttribute6:
- type: string
- description: Sixth customizable extension attribute.
- nullable: true
- extensionAttribute7:
- type: string
- description: Seventh customizable extension attribute.
- nullable: true
- extensionAttribute8:
- type: string
- description: Eighth customizable extension attribute.
- nullable: true
- extensionAttribute9:
- type: string
- description: Ninth customizable extension attribute.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.userPrint:
title: userPrint
type: object
@@ -23649,7 +23678,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -24968,6 +24996,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -25735,7 +25768,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -25942,7 +25975,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -26178,6 +26211,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -26695,7 +26729,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -26711,13 +26745,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -29304,6 +29338,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/openApiDocs/v1.0/Groups.yml b/openApiDocs/v1.0/Groups.yml
index 1fc7c28c44..98eae550c2 100644
--- a/openApiDocs/v1.0/Groups.yml
+++ b/openApiDocs/v1.0/Groups.yml
@@ -519,7 +519,7 @@ paths:
tags:
- groups.directoryObject
summary: List acceptedSenders
- description: "Users in the accepted senders list can post to conversations of the group (identified in the GET request URL).\r\nMake sure you do not specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error."
+ description: "Users in the accepted senders list can post to conversations of the group (identified in the GET request URL).\r\nMake sure you don't specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-list-acceptedsenders?view=graph-rest-1.0
@@ -642,7 +642,7 @@ paths:
tags:
- groups.directoryObject
summary: List acceptedSenders
- description: "Users in the accepted senders list can post to conversations of the group (identified in the GET request URL).\r\nMake sure you do not specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error."
+ description: "Users in the accepted senders list can post to conversations of the group (identified in the GET request URL).\r\nMake sure you don't specify the same user or group in the accepted senders and rejected senders lists, otherwise you will get an error."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-list-acceptedsenders?view=graph-rest-1.0
@@ -9701,7 +9701,7 @@ paths:
tags:
- groups.groupSetting
summary: Create settings
- description: 'Create a new group setting based on the templates available in groupSettingTemplates. These settings can be at the tenant-level or at the group level. Group settings apply to only Microsoft 365 groups. The template named Group.Unified can be used to configure tenant-wide Microsoft 365 group settings, while the template named Group.Unified.Guest can be used to configure group-specific settings.'
+ description: 'Create a new group setting based on the templates available in groupSettingTemplates. These settings can be at the tenant-level or at the group level. The following group setting templates are available for groups:'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-post-settings?view=graph-rest-1.0
@@ -14352,7 +14352,7 @@ paths:
tags:
- groupSettings.groupSetting
summary: Create settings
- description: 'Create a new group setting based on the templates available in groupSettingTemplates. These settings can be at the tenant-level or at the group level. Group settings apply to only Microsoft 365 groups. The template named Group.Unified can be used to configure tenant-wide Microsoft 365 group settings, while the template named Group.Unified.Guest can be used to configure group-specific settings.'
+ description: 'Create a new group setting based on the templates available in groupSettingTemplates. These settings can be at the tenant-level or at the group level. The following group setting templates are available for groups:'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/group-post-settings?view=graph-rest-1.0
@@ -15193,6 +15193,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -15201,7 +15203,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -15264,6 +15266,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -15298,6 +15304,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -15375,11 +15383,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -15526,7 +15548,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.conversation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -16569,7 +16590,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -16596,7 +16617,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -16743,7 +16764,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -16765,7 +16786,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -16798,7 +16819,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -16896,7 +16917,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -17153,7 +17174,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.assignedLicense:
title: assignedLicense
type: object
@@ -17440,6 +17460,15 @@ components:
description: The unique identifier for an entity. Read-only.
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -17463,6 +17492,72 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.onPremisesExtensionAttributes:
+ title: onPremisesExtensionAttributes
+ type: object
+ properties:
+ extensionAttribute1:
+ type: string
+ description: First customizable extension attribute.
+ nullable: true
+ extensionAttribute10:
+ type: string
+ description: Tenth customizable extension attribute.
+ nullable: true
+ extensionAttribute11:
+ type: string
+ description: Eleventh customizable extension attribute.
+ nullable: true
+ extensionAttribute12:
+ type: string
+ description: Twelfth customizable extension attribute.
+ nullable: true
+ extensionAttribute13:
+ type: string
+ description: Thirteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute14:
+ type: string
+ description: Fourteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute15:
+ type: string
+ description: Fifteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute2:
+ type: string
+ description: Second customizable extension attribute.
+ nullable: true
+ extensionAttribute3:
+ type: string
+ description: Third customizable extension attribute.
+ nullable: true
+ extensionAttribute4:
+ type: string
+ description: Fourth customizable extension attribute.
+ nullable: true
+ extensionAttribute5:
+ type: string
+ description: Fifth customizable extension attribute.
+ nullable: true
+ extensionAttribute6:
+ type: string
+ description: Sixth customizable extension attribute.
+ nullable: true
+ extensionAttribute7:
+ type: string
+ description: Seventh customizable extension attribute.
+ nullable: true
+ extensionAttribute8:
+ type: string
+ description: Eighth customizable extension attribute.
+ nullable: true
+ extensionAttribute9:
+ type: string
+ description: Ninth customizable extension attribute.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
@@ -18693,6 +18788,7 @@ components:
subject:
type: string
description: 'Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format; each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the sub claim within the token presented to Microsoft Entra ID. The combination of issuer and subject must be unique within the app. It has a limit of 600 characters. Supports $filter (eq).'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.homeRealmDiscoveryPolicy:
@@ -19127,72 +19223,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.workingHours'
additionalProperties:
type: object
- microsoft.graph.onPremisesExtensionAttributes:
- title: onPremisesExtensionAttributes
- type: object
- properties:
- extensionAttribute1:
- type: string
- description: First customizable extension attribute.
- nullable: true
- extensionAttribute10:
- type: string
- description: Tenth customizable extension attribute.
- nullable: true
- extensionAttribute11:
- type: string
- description: Eleventh customizable extension attribute.
- nullable: true
- extensionAttribute12:
- type: string
- description: Twelfth customizable extension attribute.
- nullable: true
- extensionAttribute13:
- type: string
- description: Thirteenth customizable extension attribute.
- nullable: true
- extensionAttribute14:
- type: string
- description: Fourteenth customizable extension attribute.
- nullable: true
- extensionAttribute15:
- type: string
- description: Fifteenth customizable extension attribute.
- nullable: true
- extensionAttribute2:
- type: string
- description: Second customizable extension attribute.
- nullable: true
- extensionAttribute3:
- type: string
- description: Third customizable extension attribute.
- nullable: true
- extensionAttribute4:
- type: string
- description: Fourth customizable extension attribute.
- nullable: true
- extensionAttribute5:
- type: string
- description: Fifth customizable extension attribute.
- nullable: true
- extensionAttribute6:
- type: string
- description: Sixth customizable extension attribute.
- nullable: true
- extensionAttribute7:
- type: string
- description: Seventh customizable extension attribute.
- nullable: true
- extensionAttribute8:
- type: string
- description: Eighth customizable extension attribute.
- nullable: true
- extensionAttribute9:
- type: string
- description: Ninth customizable extension attribute.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.passwordProfile:
title: passwordProfile
type: object
@@ -20624,7 +20654,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -21895,6 +21924,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -22466,7 +22500,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -22673,7 +22707,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -23195,6 +23229,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -23712,7 +23747,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -23728,13 +23763,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -26543,6 +26578,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/openApiDocs/v1.0/Identity.DirectoryManagement.yml b/openApiDocs/v1.0/Identity.DirectoryManagement.yml
index 63e05e7c0f..1316cc4dc6 100644
--- a/openApiDocs/v1.0/Identity.DirectoryManagement.yml
+++ b/openApiDocs/v1.0/Identity.DirectoryManagement.yml
@@ -13028,6 +13028,750 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /directory/recovery:
+ get:
+ tags:
+ - directory.recovery
+ summary: Get recovery from directory
+ operationId: directory_GetRecovery
+ parameters:
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recovery'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - directory.recovery
+ summary: Update the navigation property recovery in directory
+ operationId: directory_UpdateRecovery
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recovery'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recovery'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - directory.recovery
+ summary: Delete navigation property recovery for directory
+ operationId: directory_DeleteRecovery
+ parameters:
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /directory/recovery/jobs:
+ get:
+ tags:
+ - directory.recovery
+ summary: Get jobs from directory
+ operationId: directory.recovery_ListJob
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.entraRecoveryServices.recoveryJobBaseCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - directory.recovery
+ summary: Create new navigation property to jobs for directory
+ operationId: directory.recovery_CreateJob
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/jobs/{recoveryJobBase-id}':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get jobs from directory
+ operationId: directory.recovery_GetJob
+ parameters:
+ - name: recoveryJobBase-id
+ in: path
+ description: The unique identifier of recoveryJobBase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryJobBase
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - directory.recovery
+ summary: Update the navigation property jobs in directory
+ operationId: directory.recovery_UpdateJob
+ parameters:
+ - name: recoveryJobBase-id
+ in: path
+ description: The unique identifier of recoveryJobBase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryJobBase
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - directory.recovery
+ summary: Delete navigation property jobs for directory
+ operationId: directory.recovery_DeleteJob
+ parameters:
+ - name: recoveryJobBase-id
+ in: path
+ description: The unique identifier of recoveryJobBase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryJobBase
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/jobs/{recoveryJobBase-id}/microsoft.graph.entraRecoveryServices.cancel':
+ post:
+ tags:
+ - directory.recovery
+ summary: Invoke action cancel
+ operationId: directory.recovery.job_cancel
+ parameters:
+ - name: recoveryJobBase-id
+ in: path
+ description: The unique identifier of recoveryJobBase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryJobBase
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ /directory/recovery/jobs/$count:
+ get:
+ tags:
+ - directory.recovery
+ summary: Get the number of the resource
+ operationId: directory.recovery.job_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ /directory/recovery/snapshots:
+ get:
+ tags:
+ - directory.recovery
+ summary: Get snapshots from directory
+ operationId: directory.recovery_ListSnapshot
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.entraRecoveryServices.snapshotCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - directory.recovery
+ summary: Create new navigation property to snapshots for directory
+ operationId: directory.recovery_CreateSnapshot
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get snapshots from directory
+ operationId: directory.recovery_GetSnapshot
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - directory.recovery
+ summary: Update the navigation property snapshots in directory
+ operationId: directory.recovery_UpdateSnapshot
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - directory.recovery
+ summary: Delete navigation property snapshots for directory
+ operationId: directory.recovery_DeleteSnapshot
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryJobs':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get recoveryJobs from directory
+ operationId: directory.recovery.snapshot_ListRecoveryJob
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.entraRecoveryServices.recoveryJobCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryJobs/{recoveryJob-id}':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get recoveryJobs from directory
+ operationId: directory.recovery.snapshot_GetRecoveryJob
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - name: recoveryJob-id
+ in: path
+ description: The unique identifier of recoveryJob
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryJob
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJob'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryJobs/$count':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get the number of the resource
+ operationId: directory.recovery.snapshot.recoveryJob_GetCount
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get recoveryPreviewJobs from directory
+ operationId: directory.recovery.snapshot_ListRecoveryPreviewJob
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.entraRecoveryServices.recoveryPreviewJobCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs/{recoveryPreviewJob-id}':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get recoveryPreviewJobs from directory
+ operationId: directory.recovery.snapshot_GetRecoveryPreviewJob
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - name: recoveryPreviewJob-id
+ in: path
+ description: The unique identifier of recoveryPreviewJob
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: recoveryPreviewJob
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryPreviewJob'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/directory/recovery/snapshots/{snapshot-id}/recoveryPreviewJobs/$count':
+ get:
+ tags:
+ - directory.recovery
+ summary: Get the number of the resource
+ operationId: directory.recovery.snapshot.recoveryPreviewJob_GetCount
+ parameters:
+ - name: snapshot-id
+ in: path
+ description: The unique identifier of snapshot
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: snapshot
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ /directory/recovery/snapshots/$count:
+ get:
+ tags:
+ - directory.recovery
+ summary: Get the number of the resource
+ operationId: directory.recovery.snapshot_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
/directory/subscriptions:
get:
tags:
@@ -21217,6 +21961,9 @@ components:
type: string
description: 'Identifies a profileCardProperty resource in Get, Update, or Delete operations. Allows an administrator to surface hidden Microsoft Entra ID properties on the Microsoft 365 profile card within their tenant. When present, the Microsoft Entra ID field referenced in this property is visible to all users in your tenant on the contact pane of the profile card. Allowed values for this field are: UserPrincipalName, Fax, StreetAddress, PostalCode, StateOrProvince, Alias, CustomAttribute1, CustomAttribute2, CustomAttribute3, CustomAttribute4, CustomAttribute5, CustomAttribute6, CustomAttribute7, CustomAttribute8, CustomAttribute9, CustomAttribute10, CustomAttribute11, CustomAttribute12, CustomAttribute13, CustomAttribute14, CustomAttribute15.'
nullable: true
+ isVisible:
+ type: boolean
+ description: Indicates whether the given directory property should be shown on a user’s profile card.
additionalProperties:
type: object
microsoft.graph.profilePropertySetting:
@@ -21403,7 +22150,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -21430,7 +22177,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -21577,7 +22324,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -21599,7 +22346,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -21632,7 +22379,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -21730,7 +22477,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -21987,7 +22734,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.administrativeUnit:
allOf:
- $ref: '#/components/schemas/microsoft.graph.directoryObject'
@@ -22048,6 +22794,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -22056,7 +22804,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -22119,6 +22867,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -22153,6 +22905,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -22230,11 +22984,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -22381,7 +23149,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -22995,6 +23762,8 @@ components:
x-ms-navigationProperty: true
publicKeyInfrastructure:
$ref: '#/components/schemas/microsoft.graph.publicKeyInfrastructureRoot'
+ recovery:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recovery'
subscriptions:
type: array
items:
@@ -23440,6 +24209,122 @@ components:
description: 'The thumbprint of certificate authority certificate. Supports $filter (eq, startswith).'
additionalProperties:
type: object
+ microsoft.graph.entraRecoveryServices.recovery:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: recovery
+ type: object
+ properties:
+ jobs:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ x-ms-navigationProperty: true
+ snapshots:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryJobBase:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: recoveryJobBase
+ type: object
+ properties:
+ filteringCriteria:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobFilteringCriteriaBase'
+ jobCompletionDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ nullable: true
+ jobStartDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ status:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryStatus'
+ targetStateDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ totalChangedLinksCalculated:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ totalChangedObjectsCalculated:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.snapshot:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: snapshot
+ type: object
+ properties:
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ format: date-time
+ totalChangedObjects:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ recoveryJobs:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJob'
+ x-ms-navigationProperty: true
+ recoveryPreviewJobs:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryPreviewJob'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryJob:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ - title: recoveryJob
+ type: object
+ properties:
+ totalFailedChanges:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ totalLinksModified:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ totalObjectsModified:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ format: int32
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryPreviewJob:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ - title: recoveryPreviewJob
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.companySubscription:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23520,7 +24405,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -26303,7 +27188,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -26583,6 +27467,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -27097,6 +27990,7 @@ components:
subject:
type: string
description: 'Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format; each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the sub claim within the token presented to Microsoft Entra ID. The combination of issuer and subject must be unique within the app. It has a limit of 600 characters. Supports $filter (eq).'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.homeRealmDiscoveryPolicy:
@@ -27443,6 +28337,7 @@ components:
properties:
allowOnPremUpdateOfOnPremisesObjectIdentifierEnabled:
type: boolean
+ description: 'When true, allows on-premises directory sync clients to update the onPremisesObjectIdentifier property.'
nullable: true
blockCloudObjectTakeoverThroughHardMatchEnabled:
type: boolean
@@ -27529,6 +28424,51 @@ components:
- intermediate
- unknownFutureValue
type: string
+ microsoft.graph.entraRecoveryServices.recoveryJobFilteringCriteriaBase:
+ title: recoveryJobFilteringCriteriaBase
+ type: object
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryStatus:
+ title: recoveryStatus
+ enum:
+ - initialized
+ - running
+ - successful
+ - failed
+ - abandoned
+ - unknownFutureValue
+ - calculating
+ - loadingData
+ type: string
+ x-ms-enum:
+ name: recoveryStatus
+ modelAsString: false
+ values:
+ - value: initialized
+ description: Represents a job that has been initialized but has not been started yet
+ name: initialized
+ - value: running
+ description: Represents a job that is in progress
+ name: running
+ - value: successful
+ description: Represents a job that ran successfully and is now complete
+ name: successful
+ - value: failed
+ description: Represents a job that we were not able to run successfully
+ name: failed
+ - value: abandoned
+ description: Represents a job that was abandoned by the user
+ name: abandoned
+ - value: unknownFutureValue
+ description: This will help in making this enum evolable and adding more values in the future-
+ name: unknownFutureValue
+ - value: calculating
+ description: Represents a job for which we have started calculating the diff/preview.
+ name: calculating
+ - value: loadingData
+ description: Represents a job for which we have started loading data of the snapshot.
+ name: loadingData
microsoft.graph.servicePlanInfo:
title: servicePlanInfo
type: object
@@ -28246,6 +29186,58 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.entraRecoveryServices.recoveryJobBaseCollectionResponse:
+ title: Collection of recoveryJobBase
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBase'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.snapshotCollectionResponse:
+ title: Collection of snapshot
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshot'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryJobCollectionResponse:
+ title: Collection of recoveryJob
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJob'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.entraRecoveryServices.recoveryPreviewJobCollectionResponse:
+ title: Collection of recoveryPreviewJob
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryPreviewJob'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.companySubscriptionCollectionResponse:
title: Collection of companySubscription
type: object
@@ -28507,6 +29499,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -29376,7 +30369,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -29392,13 +30385,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -29862,6 +30855,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -30473,7 +31471,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -30642,7 +31640,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -34274,6 +35272,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -42860,6 +43863,30 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.certificateAuthorityDetailCollectionResponse'
+ microsoft.graph.entraRecoveryServices.recoveryJobBaseCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobBaseCollectionResponse'
+ microsoft.graph.entraRecoveryServices.snapshotCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.snapshotCollectionResponse'
+ microsoft.graph.entraRecoveryServices.recoveryJobCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryJobCollectionResponse'
+ microsoft.graph.entraRecoveryServices.recoveryPreviewJobCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.entraRecoveryServices.recoveryPreviewJobCollectionResponse'
microsoft.graph.companySubscriptionCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/v1.0/Identity.Governance.yml b/openApiDocs/v1.0/Identity.Governance.yml
index 9f7151b89c..15830af5d8 100644
--- a/openApiDocs/v1.0/Identity.Governance.yml
+++ b/openApiDocs/v1.0/Identity.Governance.yml
@@ -3061,7 +3061,7 @@ paths:
tags:
- identityGovernance.accessReviewSet
summary: Invoke function filterByCurrentUser
- description: 'Retrieve all decision items for an instance of an access review or a stage of an instance of a multi-stage access review, for which the calling user is the reviewer. The decision items are represented by accessReviewInstanceDecisionItem objects on a given accessReviewInstance or accessReviewStage for which the calling user is the reviewer.'
+ description: Retrieve all decision items for an instance of an access review or a stage of an instance of a multi-stage access review for which the calling user is the reviewer. The decision items are presented as accessReviewInstanceDecisionItem objects on a given accessReviewInstance or accessReviewStage for which the calling user is the reviewer.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accessreviewinstancedecisionitem-filterbycurrentuser?view=graph-rest-1.0
@@ -3220,7 +3220,7 @@ paths:
tags:
- identityGovernance.accessReviewSet
summary: Invoke action batchRecordDecisions
- description: 'Enables reviewers to review all accessReviewInstanceDecisionItem objects in batches by using principalId, resourceId, or neither.'
+ description: 'Enables reviewers to review all accessReviewInstanceDecisionItem objects in a specific accessReviewInstance in batches by using principalId, resourceId, or neither.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accessreviewinstance-batchrecorddecisions?view=graph-rest-1.0
@@ -3374,7 +3374,7 @@ paths:
tags:
- identityGovernance.accessReviewSet
summary: List stages (of an access review)
- description: Retrieve the stages in a multi-stage access review instance.
+ description: Retrieve the accessReviewStage objects for a specific accessReviewInstance in a multi-stage access review.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accessreviewinstance-list-stages?view=graph-rest-1.0
@@ -3642,7 +3642,7 @@ paths:
tags:
- identityGovernance.accessReviewSet
summary: List decisions (from a multi-stage access review)
- description: Get the decisions from a stage in a multi-stage access review. The decisions in an accessReviewStage object are represented by an accessReviewInstanceDecisionItem object.
+ description: Get the accessReviewInstanceDecisionItem objects from an accessReviewStage in a multi-stage access review.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accessreviewstage-list-decisions?view=graph-rest-1.0
@@ -4372,7 +4372,7 @@ paths:
tags:
- identityGovernance.accessReviewSet
summary: Invoke function filterByCurrentUser
- description: 'Retrieve all decision items for an instance of an access review or a stage of an instance of a multi-stage access review, for which the calling user is the reviewer. The decision items are represented by accessReviewInstanceDecisionItem objects on a given accessReviewInstance or accessReviewStage for which the calling user is the reviewer.'
+ description: Retrieve all decision items for an instance of an access review or a stage of an instance of a multi-stage access review for which the calling user is the reviewer. The decision items are presented as accessReviewInstanceDecisionItem objects on a given accessReviewInstance or accessReviewStage for which the calling user is the reviewer.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accessreviewinstancedecisionitem-filterbycurrentuser?view=graph-rest-1.0
@@ -8957,7 +8957,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Invoke action getApplicablePolicyRequirements
- description: 'In Microsoft Entra entitlement management, this action retrieves a list of accessPackageAssignmentRequestRequirements objects that the currently signed-in user can use to create an accessPackageAssignmentRequest. Each requirement object corresponds to an access package assignment policy that the currently signed-in user is allowed to request an assignment for.'
+ description: 'In Microsoft Entra entitlement management, this action retrieves accessPackageAssignmentRequestRequirements objects for an accessPackage that the currently signed-in user can use to create an accessPackageAssignmentRequest. Each requirement object corresponds to an access package assignment policy that the currently signed-in user is allowed to request an assignment for.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/accesspackage-getapplicablepolicyrequirements?view=graph-rest-1.0
@@ -12325,16 +12325,13 @@ paths:
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
- /identityGovernance/entitlementManagement/assignmentPolicies:
+ /identityGovernance/entitlementManagement/accessPackageSuggestions:
get:
tags:
- identityGovernance.entitlementManagement
- summary: List assignmentPolicies
- description: 'Retrieve a list of accessPackageAssignmentPolicy objects in Microsoft Entra entitlement management. If the delegated user is in a directory role, the resulting list includes all the assignment policies that the caller has access to read, across all catalogs and access packages. If the delegated user is an access package manager or catalog owner, they should instead retrieve the policies for the access packages they can read with list accessPackages by including $expand=assignmentPolicies as a query parameter.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/entitlementmanagement-list-assignmentpolicies?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_ListAssignmentPolicy
+ summary: Get accessPackageSuggestions from identityGovernance
+ description: Suggested access packages for end users based on various criteria such as related people insights and assignment history.
+ operationId: identityGovernance.entitlementManagement_ListAccessPackageSuggestion
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
@@ -12373,7 +12370,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.accessPackageAssignmentPolicyCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.accessPackageSuggestionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -12383,18 +12380,14 @@ paths:
post:
tags:
- identityGovernance.entitlementManagement
- summary: Create assignmentPolicies
- description: 'Create a new accessPackageAssignmentPolicy object in Microsoft Entra entitlement management. The request includes a reference to the accessPackage that contains this policy, which must already exist.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/entitlementmanagement-post-assignmentpolicies?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_CreateAssignmentPolicy
+ summary: Create new navigation property to accessPackageSuggestions for identityGovernance
+ operationId: identityGovernance.entitlementManagement_CreateAccessPackageSuggestion
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
required: true
responses:
2XX:
@@ -12402,29 +12395,26 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}':
+ '/identityGovernance/entitlementManagement/accessPackageSuggestions/{accessPackageSuggestion-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get accessPackageAssignmentPolicy
- description: "In Microsoft Entra entitlement management, retrieve the properties and relationships of an\r\n accessPackageAssignmentPolicy object."
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-get?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_GetAssignmentPolicy
+ summary: Get accessPackageSuggestions from identityGovernance
+ description: Suggested access packages for end users based on various criteria such as related people insights and assignment history.
+ operationId: identityGovernance.entitlementManagement_GetAccessPackageSuggestion
parameters:
- - name: accessPackageAssignmentPolicy-id
+ - name: accessPackageSuggestion-id
in: path
- description: The unique identifier of accessPackageAssignmentPolicy
+ description: The unique identifier of accessPackageSuggestion
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ x-ms-docs-key-type: accessPackageSuggestion
- name: $select
in: query
description: Select properties to be returned
@@ -12451,34 +12441,30 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- put:
+ patch:
tags:
- identityGovernance.entitlementManagement
- summary: Update accessPackageAssignmentPolicy
- description: 'Update an existing accessPackageAssignmentPolicy object to change one or more of its properties, such as the display name or description.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-update?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_SetAssignmentPolicy
+ summary: Update the navigation property accessPackageSuggestions in identityGovernance
+ operationId: identityGovernance.entitlementManagement_UpdateAccessPackageSuggestion
parameters:
- - name: accessPackageAssignmentPolicy-id
+ - name: accessPackageSuggestion-id
in: path
- description: The unique identifier of accessPackageAssignmentPolicy
+ description: The unique identifier of accessPackageSuggestion
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ x-ms-docs-key-type: accessPackageSuggestion
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
required: true
responses:
2XX:
@@ -12486,28 +12472,24 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- identityGovernance.entitlementManagement
- summary: Delete accessPackageAssignmentPolicy
- description: 'In Microsoft Entra entitlement management, delete an accessPackageAssignmentPolicy.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-delete?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_DeleteAssignmentPolicy
+ summary: Delete navigation property accessPackageSuggestions for identityGovernance
+ operationId: identityGovernance.entitlementManagement_DeleteAccessPackageSuggestion
parameters:
- - name: accessPackageAssignmentPolicy-id
+ - name: accessPackageSuggestion-id
in: path
- description: The unique identifier of accessPackageAssignmentPolicy
+ description: The unique identifier of accessPackageSuggestion
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ x-ms-docs-key-type: accessPackageSuggestion
- name: If-Match
in: header
description: ETag
@@ -12520,22 +12502,22 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/accessPackage':
+ '/identityGovernance/entitlementManagement/accessPackageSuggestions/{accessPackageSuggestion-id}/accessPackage':
get:
tags:
- identityGovernance.entitlementManagement
summary: Get accessPackage from identityGovernance
- description: Access package containing this policy. Read-only. Supports $expand.
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetAccessPackage
+ description: The access package information for the suggested package.
+ operationId: identityGovernance.entitlementManagement.accessPackageSuggestion_GetAccessPackage
parameters:
- - name: accessPackageAssignmentPolicy-id
+ - name: accessPackageSuggestion-id
in: path
- description: The unique identifier of accessPackageAssignmentPolicy
+ description: The unique identifier of accessPackageSuggestion
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ x-ms-docs-key-type: accessPackageSuggestion
- name: $select
in: query
description: Select properties to be returned
@@ -12562,26 +12544,47 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackage'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/catalog':
+ /identityGovernance/entitlementManagement/accessPackageSuggestions/$count:
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get catalog from identityGovernance
- description: Catalog of the access package containing this policy. Read-only.
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetCatalog
+ summary: Get the number of the resource
+ operationId: identityGovernance.entitlementManagement.accessPackageSuggestion_GetCount
parameters:
- - name: accessPackageAssignmentPolicy-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/identityGovernance/entitlementManagement/accessPackageSuggestions/microsoft.graph.filterByCurrentUser(on=''{on}'')':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Invoke function filterByCurrentUser
+ description: Retrieve suggested accessPackageSuggestion objects for the current end user. This operation returns access packages that are suggested based on various criteria such as related people insights and the user's assignment history. The suggestions help end users discover relevant access packages they may need for their role or work context.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagesuggestions-filterbycurrentuser?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.accessPackageSuggestion_filterGraphBPreCurrentUser
+ parameters:
+ - name: on
in: path
- description: The unique identifier of accessPackageAssignmentPolicy
+ description: 'Usage: on=''{on}'''
required: true
style: simple
schema:
- type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestionFilterByCurrentUserOptions'
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
@@ -12592,6 +12595,16 @@ paths:
type: array
items:
type: string
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
- name: $expand
in: query
description: Expand related entities
@@ -12604,30 +12617,39 @@ paths:
type: string
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ title: Collection of accessPackageSuggestion
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings':
+ x-ms-docs-operation-type: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ /identityGovernance/entitlementManagement/assignmentPolicies:
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get customExtensionStageSettings from identityGovernance
- description: The collection of stages when to execute one or more custom access package workflow extensions. Supports $expand.
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_ListCustomExtensionStageSetting
+ summary: List assignmentPolicies
+ description: 'Retrieve a list of accessPackageAssignmentPolicy objects in Microsoft Entra entitlement management. If the delegated user is in a directory role, the resulting list includes all the assignment policies that the caller has access to read, across all catalogs and access packages. If the delegated user is an access package manager or catalog owner, they should instead retrieve the policies for the access packages they can read with list accessPackages by including $expand=assignmentPolicies as a query parameter.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/entitlementmanagement-list-assignmentpolicies?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_ListAssignmentPolicy
parameters:
- - name: accessPackageAssignmentPolicy-id
- in: path
- description: The unique identifier of accessPackageAssignmentPolicy
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -12665,7 +12687,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.customExtensionStageSettingCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.accessPackageAssignmentPolicyCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -12675,23 +12697,18 @@ paths:
post:
tags:
- identityGovernance.entitlementManagement
- summary: Create new navigation property to customExtensionStageSettings for identityGovernance
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_CreateCustomExtensionStageSetting
- parameters:
- - name: accessPackageAssignmentPolicy-id
- in: path
- description: The unique identifier of accessPackageAssignmentPolicy
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: accessPackageAssignmentPolicy
+ summary: Create assignmentPolicies
+ description: 'Create a new accessPackageAssignmentPolicy object in Microsoft Entra entitlement management. The request includes a reference to the accessPackage that contains this policy, which must already exist.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/entitlementmanagement-post-assignmentpolicies?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_CreateAssignmentPolicy
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
required: true
responses:
2XX:
@@ -12699,17 +12716,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings/{customExtensionStageSetting-id}':
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get customExtensionStageSettings from identityGovernance
- description: The collection of stages when to execute one or more custom access package workflow extensions. Supports $expand.
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetCustomExtensionStageSetting
+ summary: Get accessPackageAssignmentPolicy
+ description: "In Microsoft Entra entitlement management, retrieve the properties and relationships of an\r\n accessPackageAssignmentPolicy object."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-get?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_GetAssignmentPolicy
parameters:
- name: accessPackageAssignmentPolicy-id
in: path
@@ -12719,14 +12739,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageAssignmentPolicy
- - name: customExtensionStageSetting-id
- in: path
- description: The unique identifier of customExtensionStageSetting
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customExtensionStageSetting
- name: $select
in: query
description: Select properties to be returned
@@ -12753,15 +12765,19 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- patch:
+ put:
tags:
- identityGovernance.entitlementManagement
- summary: Update the navigation property customExtensionStageSettings in identityGovernance
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_UpdateCustomExtensionStageSetting
+ summary: Update accessPackageAssignmentPolicy
+ description: 'Update an existing accessPackageAssignmentPolicy object to change one or more of its properties, such as the display name or description.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-update?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_SetAssignmentPolicy
parameters:
- name: accessPackageAssignmentPolicy-id
in: path
@@ -12771,20 +12787,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageAssignmentPolicy
- - name: customExtensionStageSetting-id
- in: path
- description: The unique identifier of customExtensionStageSetting
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customExtensionStageSetting
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
required: true
responses:
2XX:
@@ -12792,15 +12800,19 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentPolicy'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- identityGovernance.entitlementManagement
- summary: Delete navigation property customExtensionStageSettings for identityGovernance
- operationId: identityGovernance.entitlementManagement.assignmentPolicy_DeleteCustomExtensionStageSetting
+ summary: Delete accessPackageAssignmentPolicy
+ description: 'In Microsoft Entra entitlement management, delete an accessPackageAssignmentPolicy.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentpolicy-delete?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_DeleteAssignmentPolicy
parameters:
- name: accessPackageAssignmentPolicy-id
in: path
@@ -12810,14 +12822,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageAssignmentPolicy
- - name: customExtensionStageSetting-id
- in: path
- description: The unique identifier of customExtensionStageSetting
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customExtensionStageSetting
- name: If-Match
in: header
description: ETag
@@ -12830,13 +12834,13 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings/{customExtensionStageSetting-id}/customExtension':
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/accessPackage':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get customExtension from identityGovernance
- description: Indicates the custom workflow extension that will be executed at this stage. Nullable. Supports $expand.
- operationId: identityGovernance.entitlementManagement.assignmentPolicy.customExtensionStageSetting_GetCustomExtension
+ summary: Get accessPackage from identityGovernance
+ description: Access package containing this policy. Read-only. Supports $expand.
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetAccessPackage
parameters:
- name: accessPackageAssignmentPolicy-id
in: path
@@ -12846,14 +12850,324 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageAssignmentPolicy
- - name: customExtensionStageSetting-id
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.accessPackage'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/catalog':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get catalog from identityGovernance
+ description: Catalog of the access package containing this policy. Read-only.
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetCatalog
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
in: path
- description: The unique identifier of customExtensionStageSetting
+ description: The unique identifier of accessPackageAssignmentPolicy
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: customExtensionStageSetting
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get customExtensionStageSettings from identityGovernance
+ description: The collection of stages when to execute one or more custom access package workflow extensions. Supports $expand.
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_ListCustomExtensionStageSetting
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.customExtensionStageSettingCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Create new navigation property to customExtensionStageSettings for identityGovernance
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_CreateCustomExtensionStageSetting
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings/{customExtensionStageSetting-id}':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get customExtensionStageSettings from identityGovernance
+ description: The collection of stages when to execute one or more custom access package workflow extensions. Supports $expand.
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetCustomExtensionStageSetting
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - name: customExtensionStageSetting-id
+ in: path
+ description: The unique identifier of customExtensionStageSetting
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customExtensionStageSetting
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Update the navigation property customExtensionStageSettings in identityGovernance
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_UpdateCustomExtensionStageSetting
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - name: customExtensionStageSetting-id
+ in: path
+ description: The unique identifier of customExtensionStageSetting
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customExtensionStageSetting
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customExtensionStageSetting'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Delete navigation property customExtensionStageSettings for identityGovernance
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy_DeleteCustomExtensionStageSetting
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - name: customExtensionStageSetting-id
+ in: path
+ description: The unique identifier of customExtensionStageSetting
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customExtensionStageSetting
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/assignmentPolicies/{accessPackageAssignmentPolicy-id}/customExtensionStageSettings/{customExtensionStageSetting-id}/customExtension':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get customExtension from identityGovernance
+ description: Indicates the custom workflow extension that will be executed at this stage. Nullable. Supports $expand.
+ operationId: identityGovernance.entitlementManagement.assignmentPolicy.customExtensionStageSetting_GetCustomExtension
+ parameters:
+ - name: accessPackageAssignmentPolicy-id
+ in: path
+ description: The unique identifier of accessPackageAssignmentPolicy
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageAssignmentPolicy
+ - name: customExtensionStageSetting-id
+ in: path
+ description: The unique identifier of customExtensionStageSetting
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customExtensionStageSetting
- name: $select
in: query
description: Select properties to be returned
@@ -14262,16 +14576,13 @@ paths:
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
- /identityGovernance/entitlementManagement/catalogs:
+ /identityGovernance/entitlementManagement/availableAccessPackages:
get:
tags:
- identityGovernance.entitlementManagement
- summary: List catalogs
- description: Retrieve a list of accessPackageCatalog objects.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/entitlementmanagement-list-catalogs?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_ListCatalog
+ summary: Get availableAccessPackages from identityGovernance
+ description: Access packages available for end users to browse and request.
+ operationId: identityGovernance.entitlementManagement_ListAvailableAccessPackage
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
@@ -14310,7 +14621,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.accessPackageCatalogCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.availableAccessPackageCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -14320,18 +14631,14 @@ paths:
post:
tags:
- identityGovernance.entitlementManagement
- summary: Create accessPackageCatalog
- description: Create a new accessPackageCatalog object.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/entitlementmanagement-post-catalogs?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_CreateCatalog
+ summary: Create new navigation property to availableAccessPackages for identityGovernance
+ operationId: identityGovernance.entitlementManagement_CreateAvailableAccessPackage
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
required: true
responses:
2XX:
@@ -14339,29 +14646,26 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}':
+ '/identityGovernance/entitlementManagement/availableAccessPackages/{availableAccessPackage-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get accessPackageCatalog
- description: Retrieve the properties and relationships of an accessPackageCatalog object.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-get?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_GetCatalog
+ summary: Get availableAccessPackages from identityGovernance
+ description: Access packages available for end users to browse and request.
+ operationId: identityGovernance.entitlementManagement_GetAvailableAccessPackage
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
+ x-ms-docs-key-type: availableAccessPackage
- name: $select
in: query
description: Select properties to be returned
@@ -14388,34 +14692,30 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- identityGovernance.entitlementManagement
- summary: Update accessPackageCatalog
- description: 'Update an existing accessPackageCatalog object to change one or more of its properties, such as the display name or description.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-update?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_UpdateCatalog
+ summary: Update the navigation property availableAccessPackages in identityGovernance
+ operationId: identityGovernance.entitlementManagement_UpdateAvailableAccessPackage
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
+ x-ms-docs-key-type: availableAccessPackage
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
required: true
responses:
2XX:
@@ -14423,28 +14723,24 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- identityGovernance.entitlementManagement
- summary: Delete accessPackageCatalog
- description: Delete an accessPackageCatalog.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-delete?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement_DeleteCatalog
+ summary: Delete navigation property availableAccessPackages for identityGovernance
+ operationId: identityGovernance.entitlementManagement_DeleteAvailableAccessPackage
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
+ x-ms-docs-key-type: availableAccessPackage
- name: If-Match
in: header
description: ETag
@@ -14457,22 +14753,25 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages':
+ '/identityGovernance/entitlementManagement/availableAccessPackages/{availableAccessPackage-id}/resourceRoleScopes':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get accessPackages from identityGovernance
- description: The access packages in this catalog. Read-only. Nullable.
- operationId: identityGovernance.entitlementManagement.catalog_ListAccessPackage
+ summary: List resourceRoleScopes
+ description: Get a list of the accessPackageResourceRoleScope objects associated with an availableAccessPackage.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/availableaccesspackage-list-resourcerolescopes?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.availableAccessPackage_ListResourceRoleScope
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
+ x-ms-docs-key-type: availableAccessPackage
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -14510,37 +14809,37 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.accessPackageCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.accessPackageResourceRoleScopeCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages/{accessPackage-id}':
+ '/identityGovernance/entitlementManagement/availableAccessPackages/{availableAccessPackage-id}/resourceRoleScopes/{accessPackageResourceRoleScope-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get accessPackages from identityGovernance
- description: The access packages in this catalog. Read-only. Nullable.
- operationId: identityGovernance.entitlementManagement.catalog_GetAccessPackage
+ summary: Get resourceRoleScopes from identityGovernance
+ description: The resource role scopes associated with this available access package.
+ operationId: identityGovernance.entitlementManagement.availableAccessPackage_GetResourceRoleScope
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
- - name: accessPackage-id
+ x-ms-docs-key-type: availableAccessPackage
+ - name: accessPackageResourceRoleScope-id
in: path
- description: The unique identifier of accessPackage
+ description: The unique identifier of accessPackageResourceRoleScope
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackage
+ x-ms-docs-key-type: accessPackageResourceRoleScope
- name: $select
in: query
description: Select properties to be returned
@@ -14567,25 +14866,25 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.accessPackage'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageResourceRoleScope'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages/$count':
+ '/identityGovernance/entitlementManagement/availableAccessPackages/{availableAccessPackage-id}/resourceRoleScopes/$count':
get:
tags:
- identityGovernance.entitlementManagement
summary: Get the number of the resource
- operationId: identityGovernance.entitlementManagement.catalog.accessPackage_GetCount
+ operationId: identityGovernance.entitlementManagement.availableAccessPackage.resourceRoleScope_GetCount
parameters:
- - name: accessPackageCatalog-id
+ - name: availableAccessPackage-id
in: path
- description: The unique identifier of accessPackageCatalog
+ description: The unique identifier of availableAccessPackage
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: accessPackageCatalog
+ x-ms-docs-key-type: availableAccessPackage
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -14593,25 +14892,31 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions':
+ /identityGovernance/entitlementManagement/availableAccessPackages/$count:
get:
tags:
- identityGovernance.entitlementManagement
- summary: List accessPackageCustomWorkflowExtensions
- description: Get a list of the accessPackageAssignmentRequestWorkflowExtension and accessPackageAssignmentWorkflowExtension objects and their properties. The resulting list includes all the customAccessPackageWorkflowExtension objects for the catalog that the caller has access to read. Each object includes an @odata.type property that indicates whether the object is an accessPackageAssignmentRequestWorkflowExtension or an accessPackageAssignmentWorkflowExtension.
+ summary: Get the number of the resource
+ operationId: identityGovernance.entitlementManagement.availableAccessPackage_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ /identityGovernance/entitlementManagement/catalogs:
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: List catalogs
+ description: Retrieve a list of accessPackageCatalog objects.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-list-accesspackagecustomworkflowextensions?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_ListCustomWorkflowExtension
+ url: https://learn.microsoft.com/graph/api/entitlementmanagement-list-catalogs?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_ListCatalog
parameters:
- - name: accessPackageCatalog-id
- in: path
- description: The unique identifier of accessPackageCatalog
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: accessPackageCatalog
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -14649,7 +14954,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.customCalloutExtensionCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.accessPackageCatalogCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -14659,27 +14964,18 @@ paths:
post:
tags:
- identityGovernance.entitlementManagement
- summary: Create accessPackageCustomWorkflowExtension
- description: Create a new accessPackageAssignmentRequestWorkflowExtension or accessPackageAssignmentWorkflowExtension object and add it to an existing accessPackageCatalog object. You must explicitly provide an @odata.type property that indicates whether the object is an accessPackageAssignmentRequestWorkflowExtension or an accessPackageAssignmentWorkflowExtension.
+ summary: Create accessPackageCatalog
+ description: Create a new accessPackageCatalog object.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-post-accesspackagecustomworkflowextensions?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_CreateCustomWorkflowExtension
- parameters:
- - name: accessPackageCatalog-id
- in: path
- description: The unique identifier of accessPackageCatalog
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: accessPackageCatalog
+ url: https://learn.microsoft.com/graph/api/entitlementmanagement-post-catalogs?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_CreateCatalog
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
required: true
responses:
2XX:
@@ -14687,20 +14983,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions/{customCalloutExtension-id}':
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get accessPackageAssignmentRequestWorkflowExtension
- description: Read the properties and relationships of an accessPackageAssignmentRequestWorkflowExtension object.
+ summary: Get accessPackageCatalog
+ description: Retrieve the properties and relationships of an accessPackageCatalog object.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-get?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_GetCustomWorkflowExtension
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-get?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_GetCatalog
parameters:
- name: accessPackageCatalog-id
in: path
@@ -14710,14 +15006,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageCatalog
- - name: customCalloutExtension-id
- in: path
- description: The unique identifier of customCalloutExtension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customCalloutExtension
- name: $select
in: query
description: Select properties to be returned
@@ -14744,19 +15032,19 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- identityGovernance.entitlementManagement
- summary: Update accessPackageAssignmentRequestWorkflowExtension
- description: Update the properties of an accessPackageAssignmentRequestWorkflowExtension object.
+ summary: Update accessPackageCatalog
+ description: 'Update an existing accessPackageCatalog object to change one or more of its properties, such as the display name or description.'
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-update?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_UpdateCustomWorkflowExtension
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-update?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_UpdateCatalog
parameters:
- name: accessPackageCatalog-id
in: path
@@ -14766,20 +15054,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageCatalog
- - name: customCalloutExtension-id
- in: path
- description: The unique identifier of customCalloutExtension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customCalloutExtension
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
required: true
responses:
2XX:
@@ -14787,19 +15067,19 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ $ref: '#/components/schemas/microsoft.graph.accessPackageCatalog'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- identityGovernance.entitlementManagement
- summary: Delete accessPackageAssignmentRequestWorkflowExtension
- description: 'Delete an accessPackageAssignmentRequestWorkflowExtension object. The custom workflow extension must first be removed from any associated policies before it can be deleted. Follow these steps to remove the custom workflow extension from any associated policies:'
+ summary: Delete accessPackageCatalog
+ description: Delete an accessPackageCatalog.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-delete?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_DeleteCustomWorkflowExtension
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-delete?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement_DeleteCatalog
parameters:
- name: accessPackageCatalog-id
in: path
@@ -14809,14 +15089,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageCatalog
- - name: customCalloutExtension-id
- in: path
- description: The unique identifier of customCalloutExtension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: customCalloutExtension
- name: If-Match
in: header
description: ETag
@@ -14829,12 +15101,13 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions/$count':
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages':
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get the number of the resource
- operationId: identityGovernance.entitlementManagement.catalog.customWorkflowExtension_GetCount
+ summary: Get accessPackages from identityGovernance
+ description: The access packages in this catalog. Read-only. Nullable.
+ operationId: identityGovernance.entitlementManagement.catalog_ListAccessPackage
parameters:
- name: accessPackageCatalog-id
in: path
@@ -14844,23 +15117,57 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageCatalog
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ $ref: '#/components/responses/microsoft.graph.accessPackageCollectionResponse'
default:
$ref: '#/components/responses/error'
- '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/resourceRoles':
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages/{accessPackage-id}':
get:
tags:
- identityGovernance.entitlementManagement
- summary: List resourceRoles
- description: 'Retrieve a list of accessPackageResourceRole objects of an accessPackageResource in an accessPackageCatalog. The resource should have been added to the catalog by creating an accessPackageResourceRequest. This list of roles can then be used by the caller to select a role, which is needed when subsequently creating an accessPackageResourceRoleScope.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/accesspackagecatalog-list-resourceroles?view=graph-rest-1.0
- operationId: identityGovernance.entitlementManagement.catalog_ListResourceRole
+ summary: Get accessPackages from identityGovernance
+ description: The access packages in this catalog. Read-only. Nullable.
+ operationId: identityGovernance.entitlementManagement.catalog_GetAccessPackage
parameters:
- name: accessPackageCatalog-id
in: path
@@ -14870,21 +15177,358 @@ paths:
schema:
type: string
x-ms-docs-key-type: accessPackageCatalog
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- - $ref: '#/components/parameters/count'
- - name: $orderby
- in: query
- description: Order items by property values
- style: form
- explode: false
+ - name: accessPackage-id
+ in: path
+ description: The unique identifier of accessPackage
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: accessPackage
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.accessPackage'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/accessPackages/$count':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get the number of the resource
+ operationId: identityGovernance.entitlementManagement.catalog.accessPackage_GetCount
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: List accessPackageCustomWorkflowExtensions
+ description: List the accessPackageAssignmentRequestWorkflowExtension and accessPackageAssignmentWorkflowExtension objects in the accessPackageCustomWorkflowExtensions relationship of an accessPackageCatalog. The resulting list includes all the customAccessPackageWorkflowExtension objects for the catalog that the caller has access to read. Each object includes an @odata.type property that indicates whether the object is an accessPackageAssignmentRequestWorkflowExtension or an accessPackageAssignmentWorkflowExtension.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-list-accesspackagecustomworkflowextensions?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_ListCustomWorkflowExtension
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.customCalloutExtensionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Create accessPackageCustomWorkflowExtension
+ description: Create a new accessPackageAssignmentRequestWorkflowExtension or accessPackageAssignmentWorkflowExtension object in the accessPackageCustomWorkflowExtensions relationship of an accessPackageCatalog. You must explicitly provide an @odata.type property that indicates whether the object is an accessPackageAssignmentRequestWorkflowExtension or an accessPackageAssignmentWorkflowExtension.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-post-accesspackagecustomworkflowextensions?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_CreateCustomWorkflowExtension
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions/{customCalloutExtension-id}':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get accessPackageAssignmentRequestWorkflowExtension
+ description: Read the properties and relationships of an accessPackageAssignmentRequestWorkflowExtension object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-get?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_GetCustomWorkflowExtension
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - name: customCalloutExtension-id
+ in: path
+ description: The unique identifier of customCalloutExtension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customCalloutExtension
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Update accessPackageAssignmentRequestWorkflowExtension
+ description: Update the properties of an accessPackageAssignmentRequestWorkflowExtension object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-update?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_UpdateCustomWorkflowExtension
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - name: customCalloutExtension-id
+ in: path
+ description: The unique identifier of customCalloutExtension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customCalloutExtension
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.customCalloutExtension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Delete accessPackageAssignmentRequestWorkflowExtension
+ description: 'Delete an accessPackageAssignmentRequestWorkflowExtension object. The custom workflow extension must first be removed from any associated policies before it can be deleted. Follow these steps to remove the custom workflow extension from any associated policies:'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackageassignmentrequestworkflowextension-delete?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_DeleteCustomWorkflowExtension
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - name: customCalloutExtension-id
+ in: path
+ description: The unique identifier of customCalloutExtension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: customCalloutExtension
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/customWorkflowExtensions/$count':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get the number of the resource
+ operationId: identityGovernance.entitlementManagement.catalog.customWorkflowExtension_GetCount
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalog-id}/resourceRoles':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: List resourceRoles
+ description: 'Retrieve a list of accessPackageResourceRole objects of an accessPackageResource in an accessPackageCatalog. The resource should have been added to the catalog by creating an accessPackageResourceRequest. This list of roles can then be used by the caller to select a role, which is needed when subsequently creating an accessPackageResourceRoleScope.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagecatalog-list-resourceroles?view=graph-rest-1.0
+ operationId: identityGovernance.entitlementManagement.catalog_ListResourceRole
+ parameters:
+ - name: accessPackageCatalog-id
+ in: path
+ description: The unique identifier of accessPackageCatalog
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: accessPackageCatalog
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
- name: $select
in: query
description: Select properties to be returned
@@ -20994,7 +21638,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Remove externalSponsors
- description: Remove a user or a group from the connected organization's external sponsors. The external sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Remove a user or a group from the externalSponsors relationship of a connectedOrganization. External sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-delete-externalsponsors?view=graph-rest-1.0
@@ -21093,7 +21737,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Add externalSponsors
- description: Add a user or a group to the connected organization's external sponsors. The external sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Add a user or a group to the externalSponsors relationship of a connectedOrganization. External sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-post-externalsponsors?view=graph-rest-1.0
@@ -21119,7 +21763,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Remove externalSponsors
- description: Remove a user or a group from the connected organization's external sponsors. The external sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Remove a user or a group from the externalSponsors relationship of a connectedOrganization. External sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-delete-externalsponsors?view=graph-rest-1.0
@@ -21217,7 +21861,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Remove internalSponsors
- description: Remove a user or a group from the connected organization's internal sponsors. The internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Remove a user or a group from the internalSponsors relationship of a connectedOrganization. Internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-delete-internalsponsors?view=graph-rest-1.0
@@ -21316,7 +21960,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Add internalSponsors
- description: Add a user or a group to the connected organization's internal sponsors. The internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Add a user or a group to the internalSponsors relationship of a connectedOrganization. Internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-post-internalsponsors?view=graph-rest-1.0
@@ -21342,7 +21986,7 @@ paths:
tags:
- identityGovernance.entitlementManagement
summary: Remove internalSponsors
- description: Remove a user or a group from the connected organization's internal sponsors. The internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
+ description: Remove a user or a group from the internalSponsors relationship of a connectedOrganization. Internal sponsors are a set of users who can approve requests on behalf of other users from that connected organization.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/connectedorganization-delete-internalsponsors?view=graph-rest-1.0
@@ -21390,6 +22034,197 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /identityGovernance/entitlementManagement/controlConfigurations:
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get controlConfigurations from identityGovernance
+ description: Configuration settings that control the lifecycle and access policies of entitlement management within a tenant.
+ operationId: identityGovernance.entitlementManagement_ListControlConfiguration
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.controlConfigurationCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Create new navigation property to controlConfigurations for identityGovernance
+ operationId: identityGovernance.entitlementManagement_CreateControlConfiguration
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/entitlementManagement/controlConfigurations/{controlConfiguration-id}':
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get controlConfigurations from identityGovernance
+ description: Configuration settings that control the lifecycle and access policies of entitlement management within a tenant.
+ operationId: identityGovernance.entitlementManagement_GetControlConfiguration
+ parameters:
+ - name: controlConfiguration-id
+ in: path
+ description: The unique identifier of controlConfiguration
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: controlConfiguration
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ put:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Update the navigation property controlConfigurations in identityGovernance
+ operationId: identityGovernance.entitlementManagement_SetControlConfiguration
+ parameters:
+ - name: controlConfiguration-id
+ in: path
+ description: The unique identifier of controlConfiguration
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: controlConfiguration
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Delete navigation property controlConfigurations for identityGovernance
+ operationId: identityGovernance.entitlementManagement_DeleteControlConfiguration
+ parameters:
+ - name: controlConfiguration-id
+ in: path
+ description: The unique identifier of controlConfiguration
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: controlConfiguration
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /identityGovernance/entitlementManagement/controlConfigurations/$count:
+ get:
+ tags:
+ - identityGovernance.entitlementManagement
+ summary: Get the number of the resource
+ operationId: identityGovernance.entitlementManagement.controlConfiguration_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
/identityGovernance/entitlementManagement/resourceEnvironments:
get:
tags:
@@ -37913,7 +38748,11 @@ paths:
get:
tags:
- identityGovernance.entitlementManagement
- summary: Get subjects from identityGovernance
+ summary: Get accessPackageSubject
+ description: Get the properties of an external directory user represented by an existing accessPackageSubject object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagesubject-get?view=graph-rest-1.0
operationId: identityGovernance.entitlementManagement_ListSubject
parameters:
- $ref: '#/components/parameters/top'
@@ -38030,7 +38869,11 @@ paths:
patch:
tags:
- identityGovernance.entitlementManagement
- summary: Update the navigation property subjects in identityGovernance
+ summary: Update accessPackageSubject
+ description: Update an external directory user represented by an existing accessPackageSubject object to change the subject lifecycle.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagesubject-update?view=graph-rest-1.0
operationId: identityGovernance.entitlementManagement_UpdateSubject
parameters:
- name: accessPackageSubject-id
@@ -38178,7 +39021,11 @@ paths:
patch:
tags:
- identityGovernance.entitlementManagement
- summary: Update the navigation property subjects in identityGovernance
+ summary: Update accessPackageSubject
+ description: Update an external directory user represented by an existing accessPackageSubject object to change the subject lifecycle.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/accesspackagesubject-update?view=graph-rest-1.0
operationId: identityGovernance.entitlementManagement.subject_UpdateGraphBPreObjectId
parameters:
- name: objectId
@@ -38997,7 +39844,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: List deletedItems (deleted lifecycle workflows)
- description: Get a list of the deleted workflow objects and their properties.
+ description: Get a list of deleted workflow objects and their properties from the deletedItemContainer.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-lifecycleworkflowscontainer-list-deleteditems?view=graph-rest-1.0
@@ -39774,18 +40621,447 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/lastModifiedBy/serviceProvisioningErrors/$count':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get the number of the resource
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow.lastModifiedBy.ServiceProvisioningError_GetCount
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.activate':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action activate
+ description: 'Run a workflow object on-demand. You can run any workflow on-demand, including scheduled workflows. Workflows created from the ''Real-time employee termination'' template are run on-demand only. When you run a workflow on demand, the tasks are executed regardless of whether the user state matches the scope and trigger execution conditions.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-activate?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_activate
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ subjects:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.user'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.activateWithScope':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action activateWithScope
+ description: 'Run a workflow object on-demand with a specific scope. You can run any workflow on-demand, including scheduled workflows. Workflows created from the ''Real-time employee termination'' template are run on-demand only. When you run a workflow on demand, the tasks are executed regardless of whether the user state matches the scope and trigger execution conditions.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-activatewithscope?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_activateGraphWPreScope
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ scope:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.activationScope'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.cancelProcessing':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action cancelProcessing
+ description: Cancel one or more workflow runs that are currently in queued or inProgress status. Currently limited to canceling one run per request.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-cancelprocessing?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_cancelProcessing
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ scope:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.cancelScope'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.clearQuarantine':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action clearQuarantine
+ description: 'Release a quarantined workflow so that it resumes processing. A workflow is automatically quarantined when a run exceeds the threshold conditions defined in its quarantineConfiguration. After an administrator reviews the cause of the quarantine, calling this action clears the quarantine state and allows the workflow to run again.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-clearquarantine?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_clearQuarantine
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.createNewVersion':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action createNewVersion
+ description: Create a new version of the workflow object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-createnewversion?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_createNewVersion
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ workflow:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.previewTaskFailures':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action previewTaskFailures
+ description: 'Validate the tasks configured in a workflow to check for configuration errors. This action identifies any tasks that would fail during execution, allowing you to fix issues before running the workflow. Returns an empty collection if no task failures are detected.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-previewtaskfailures?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_previewTaskFailure
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.previewFailedTask'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.previewWorkflow':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action previewWorkflow
+ description: 'Run a workflow in preview mode for selected directory objects without affecting production users. This action triggers workflow processing in preview mode, and results can be retrieved by using the List userProcessingResults operation with $filter=workflowExecutionType eq ''previewMode''.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-previewworkflow?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_previewWorkflow
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ subjects:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.directoryObject'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.restore':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action restore
+ description: Restore a deleted workflow object. You can only restore a workflow that was deleted within the last 30 days before Microsoft Entra ID automatically permanently deletes it.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-restore?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_restore
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/previewScope':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get previewScope from identityGovernance
+ description: The preview scope for the workflow.
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_ListPreviewScope
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/previewScope/{directoryObject-id}':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get previewScope from identityGovernance
+ description: The preview scope for the workflow.
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_GetPreviewScope
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - name: directoryObject-id
+ in: path
+ description: The unique identifier of directoryObject
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: directoryObject
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.directoryObject'
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/lastModifiedBy/serviceProvisioningErrors/$count':
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/previewScope/$count':
get:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Get the number of the resource
- operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow.lastModifiedBy.ServiceProvisioningError_GetCount
+ operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow.previewScope_GetCount
parameters:
- name: workflow-id
in: path
@@ -39802,152 +41078,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.activate':
- post:
- tags:
- - identityGovernance.lifecycleWorkflowsContainer
- summary: Invoke action activate
- description: 'Run a workflow object on-demand. You can run any workflow on-demand, including scheduled workflows. Workflows created from the ''Real-time employee termination'' template are run on-demand only. When you run a workflow on demand, the tasks are executed regardless of whether the user state matches the scope and trigger execution conditions.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-activate?view=graph-rest-1.0
- operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_activate
- parameters:
- - name: workflow-id
- in: path
- description: The unique identifier of workflow
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: workflow
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- subjects:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.user'
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.activateWithScope':
- post:
- tags:
- - identityGovernance.lifecycleWorkflowsContainer
- summary: Invoke action activateWithScope
- description: 'Run a workflow object on-demand with a specific scope. You can run any workflow on-demand, including scheduled workflows. Workflows created from the ''Real-time employee termination'' template are run on-demand only. When you run a workflow on demand, the tasks are executed regardless of whether the user state matches the scope and trigger execution conditions.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-activatewithscope?view=graph-rest-1.0
- operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_activateGraphWPreScope
- parameters:
- - name: workflow-id
- in: path
- description: The unique identifier of workflow
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: workflow
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- scope:
- $ref: '#/components/schemas/microsoft.graph.identityGovernance.activationScope'
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.createNewVersion':
- post:
- tags:
- - identityGovernance.lifecycleWorkflowsContainer
- summary: Invoke action createNewVersion
- description: Create a new version of the workflow object.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-createnewversion?view=graph-rest-1.0
- operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_createNewVersion
- parameters:
- - name: workflow-id
- in: path
- description: The unique identifier of workflow
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: workflow
- requestBody:
- description: Action parameters
- content:
- application/json:
- schema:
- type: object
- properties:
- workflow:
- $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
- additionalProperties:
- type: object
- required: true
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
- '/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/microsoft.graph.identityGovernance.restore':
- post:
- tags:
- - identityGovernance.lifecycleWorkflowsContainer
- summary: Invoke action restore
- description: Restore a workflow that has been deleted. You can only restore a workflow that was deleted within the last 30 days before Microsoft Entra ID automatically permanently deletes it.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-restore?view=graph-rest-1.0
- operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_restore
- parameters:
- - name: workflow-id
- in: path
- description: The unique identifier of workflow
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: workflow
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: action
'/identityGovernance/lifecycleWorkflows/deletedItems/workflows/{workflow-id}/runs':
get:
tags:
@@ -40357,7 +41487,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -41532,7 +42662,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -42527,7 +43657,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -43373,7 +44503,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -44474,7 +45604,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -46197,7 +47327,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -46865,7 +47995,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function topTasksProcessedSummary
- description: 'Provide a summary of the most processed tasks, known as top tasks, for a specified time period in a tenant. The task definition is provided, along with numerical counts of total, successful, and failed runs. For information about workflows processed, see insights: topWorkflowsProcessedSummary.'
+ description: 'Provide a summary from the insights resource of the most processed task objects, known as top tasks, for a specified time period in a tenant. The task definition is provided, along with numerical counts of total, successful, and failed runs. For information about workflows processed, see insights: topWorkflowsProcessedSummary.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-insights-toptasksprocessedsummary?view=graph-rest-1.0
@@ -46922,7 +48052,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function topWorkflowsProcessedSummary
- description: 'Provide a summary of the workflows processed the most, known as top workflows, for a specified period in a tenant. Workflow basic details are given, along with run information. For information about tasks processed, see insights: topTasksProcessedSummary.'
+ description: 'Provide a summary from the insights resource of the workflow objects processed the most, known as top workflows, for a specified period in a tenant. Workflow basic details are given, along with run information. For information about tasks processed, see insights: topTasksProcessedSummary.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-insights-topworkflowsprocessedsummary?view=graph-rest-1.0
@@ -46979,7 +48109,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function workflowsProcessedByCategory
- description: 'Provide a summary of workflows processed, by category, in a tenant. This allows you to quickly get category information, by numerical value, bypassing other information found in the WorkflowsProcessedSummary call.'
+ description: 'Provide a summary from the insights resource of workflow objects processed by category in a tenant. This allows you to quickly get category information, by numerical value, without retrieving the other information included in the workflowsProcessedSummary call.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-insights-workflowsprocessedbycategory?view=graph-rest-1.0
@@ -47018,7 +48148,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function workflowsProcessedSummary
- description: 'Provide a summary of all workflows processed within a tenant for a specified period. Because the amount of results for listed workflows as returned by the List workflows does not tell you which workflows were processed from the list of created workflows, this summary gives you a quick overview of processed status based on counts.'
+ description: 'Provide a summary from the insights resource of workflow objects processed within a tenant for a specified period. Because the list returned by List workflows doesn''t indicate which workflows were processed, this summary gives you a quick overview based on counts.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-insights-workflowsprocessedsummary?view=graph-rest-1.0
@@ -47242,7 +48372,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: List workflows
- description: Get a list of workflow resources that are associated with lifecycle workflows.
+ description: Get a list of workflow resources that are associated with Lifecycle Workflows.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-lifecycleworkflowscontainer-list-workflows?view=graph-rest-1.0
@@ -47406,7 +48536,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Delete workflow
- description: 'Delete a workflow object and its associated tasks, taskProcessingResults and versions. You can restore a deleted workflow and its associated objects within 30 days of deletion.'
+ description: 'Delete a workflow object and its associated tasks, taskProcessingResults and versions. The deleted workflow is sent to the deleted workflows container. You can restore a deleted workflow and its associated objects within 30 days of deletion.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-delete?view=graph-rest-1.0
@@ -48184,6 +49314,72 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.cancelProcessing':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action cancelProcessing
+ description: Cancel one or more workflow runs that are currently in queued or inProgress status. Currently limited to canceling one run per request.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-cancelprocessing?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.workflow_cancelProcessing
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ scope:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.cancelScope'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.clearQuarantine':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action clearQuarantine
+ description: 'Release a quarantined workflow so that it resumes processing. A workflow is automatically quarantined when a run exceeds the threshold conditions defined in its quarantineConfiguration. After an administrator reviews the cause of the quarantine, calling this action clears the quarantine state and allows the workflow to run again.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-clearquarantine?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.workflow_clearQuarantine
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflow'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
'/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.createNewVersion':
post:
tags:
@@ -48225,12 +49421,93 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.previewTaskFailures':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action previewTaskFailures
+ description: 'Validate the tasks configured in a workflow to check for configuration errors. This action identifies any tasks that would fail during execution, allowing you to fix issues before running the workflow. Returns an empty collection if no task failures are detected.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-previewtaskfailures?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.workflow_previewTaskFailure
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.previewFailedTask'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.previewWorkflow':
+ post:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Invoke action previewWorkflow
+ description: 'Run a workflow in preview mode for selected directory objects without affecting production users. This action triggers workflow processing in preview mode, and results can be retrieved by using the List userProcessingResults operation with $filter=workflowExecutionType eq ''previewMode''.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-previewworkflow?view=graph-rest-1.0
+ operationId: identityGovernance.lifecycleWorkflow.workflow_previewWorkflow
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ subjects:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.directoryObject'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
'/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/microsoft.graph.identityGovernance.restore':
post:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action restore
- description: Restore a workflow that has been deleted. You can only restore a workflow that was deleted within the last 30 days before Microsoft Entra ID automatically permanently deletes it.
+ description: Restore a deleted workflow object. You can only restore a workflow that was deleted within the last 30 days before Microsoft Entra ID automatically permanently deletes it.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-restore?view=graph-rest-1.0
@@ -48254,12 +49531,148 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/previewScope':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get previewScope from identityGovernance
+ description: The preview scope for the workflow.
+ operationId: identityGovernance.lifecycleWorkflow.workflow_ListPreviewScope
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/previewScope/{directoryObject-id}':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get previewScope from identityGovernance
+ description: The preview scope for the workflow.
+ operationId: identityGovernance.lifecycleWorkflow.workflow_GetPreviewScope
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - name: directoryObject-id
+ in: path
+ description: The unique identifier of directoryObject
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: directoryObject
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.directoryObject'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/previewScope/$count':
+ get:
+ tags:
+ - identityGovernance.lifecycleWorkflowsContainer
+ summary: Get the number of the resource
+ operationId: identityGovernance.lifecycleWorkflow.workflow.previewScope_GetCount
+ parameters:
+ - name: workflow-id
+ in: path
+ description: The unique identifier of workflow
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: workflow
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
'/identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/runs':
get:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: List runs
- description: Get a list of the run objects and their properties for a lifecycle workflow.
+ description: Get a list of run objects and their properties for a workflow.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-list-runs?view=graph-rest-1.0
@@ -48672,7 +50085,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -49176,7 +50589,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Get userProcessingResult
- description: Get the user processing result of a user processing result of a run.
+ description: Get a userProcessingResult for a run.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-userprocessingresult-get?view=graph-rest-1.0
@@ -49856,7 +51269,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -50456,7 +51869,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function summary
- description: 'Get a summary of runs for a specified time period. Because the amount of runs returned by the List API call can be overwhelming, this summary allows the administrator to get a quick overview based on counts.'
+ description: 'Get a runSummary for run objects over a specified time period. Because the number of runs returned by the list API call can be overwhelming, this summary allows administrators to get a quick overview based on counts.'
operationId: identityGovernance.lifecycleWorkflow.workflow.run_summary
parameters:
- name: workflow-id
@@ -50858,7 +52271,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -51313,7 +52726,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke function summary
- description: 'Get a taskReportSummary object. This API provides a summary of task processing results for a specified time period. Because the volume of task processing results and task reports returned by the List API calls can be overwhelming, this summary allows the administrator to get a quick overview based on counts.'
+ description: 'Get a taskReportSummary for a taskReport. This API provides a summary of task processing results for a specified time period. Because the volume of task processing results and task reports returned by the List API calls can be overwhelming, this summary allows the administrator to get a quick overview based on counts.'
operationId: identityGovernance.lifecycleWorkflow.workflow.taskReport_summary
parameters:
- name: workflow-id
@@ -51357,7 +52770,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: List tasks (in Lifecycle Workflows)
- description: Retrieve the details of the built-in tasks in Lifecycle Workflows.
+ description: Retrieve the details of the built-in task objects in a workflow.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-workflow-list-task?view=graph-rest-1.0
@@ -51711,7 +53124,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -52818,7 +54231,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -54553,7 +55966,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -55491,7 +56904,7 @@ paths:
tags:
- identityGovernance.lifecycleWorkflowsContainer
summary: Invoke action resume
- description: 'Resume a task processing result that''s inProgress. In the default case an Azure Logic Apps system-assigned managed identity calls this API. For more information, see: Lifecycle Workflows extensibility approach.'
+ description: 'Resume a taskProcessingResult that''s inProgress. In the default case, an Azure Logic Apps system-assigned managed identity calls this API. For more information, see Lifecycle Workflows extensibility approach.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/identitygovernance-taskprocessingresult-resume?view=graph-rest-1.0
@@ -71095,6 +72508,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.accessPackage'
description: Access packages define the collection of resource roles and the policies for which subjects can request or be assigned access to those resources.
x-ms-navigationProperty: true
+ accessPackageSuggestions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
+ description: Suggested access packages for end users based on various criteria such as related people insights and assignment history.
+ x-ms-navigationProperty: true
assignmentPolicies:
type: array
items:
@@ -71113,6 +72532,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.accessPackageAssignment'
description: The assignment of an access package to a subject for a period of time.
x-ms-navigationProperty: true
+ availableAccessPackages:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
+ description: Access packages available for end users to browse and request.
+ x-ms-navigationProperty: true
catalogs:
type: array
items:
@@ -71125,6 +72550,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.connectedOrganization'
description: References to a directory or domain of another organization whose users can request access.
x-ms-navigationProperty: true
+ controlConfigurations:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ description: Configuration settings that control the lifecycle and access policies of entitlement management within a tenant.
+ x-ms-navigationProperty: true
resourceEnvironments:
type: array
items:
@@ -71500,8 +72931,10 @@ components:
nullable: true
originSystem:
type: string
- description: 'The type of the resource in the origin system, such as SharePointOnline, AadApplication, or AadGroup.'
+ description: 'The type of the resource in the origin system, such as SharePointOnline, AadApplication, AzureResources, or AadGroup.'
nullable: true
+ type:
+ $ref: '#/components/schemas/microsoft.graph.roleType'
resource:
$ref: '#/components/schemas/microsoft.graph.accessPackageResource'
additionalProperties:
@@ -71629,11 +73062,11 @@ components:
nullable: true
originId:
type: string
- description: The unique identifier for the scope in the resource as defined in the origin system.
+ description: 'The unique identifier of the resource in the origin system. If a Microsoft Entra group, originId is the identifier of the group. Supports $filter (eq).'
nullable: true
originSystem:
type: string
- description: The origin system for the scope.
+ description: 'The type of the resource in the origin system, such as SharePointOnline, AadApplication, AadGroup, AzureResources, or CustomDataProvidedResource. Supports $filter (eq).'
nullable: true
resource:
$ref: '#/components/schemas/microsoft.graph.accessPackageResource'
@@ -71645,6 +73078,53 @@ components:
- allowedRequestor
- unknownFutureValue
type: string
+ microsoft.graph.accessPackageSuggestion:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: accessPackageSuggestion
+ type: object
+ properties:
+ reasons:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestionReason'
+ description: A collection of reasons why this access package is being suggested to the user.
+ accessPackage:
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
+ additionalProperties:
+ type: object
+ microsoft.graph.availableAccessPackage:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: availableAccessPackage
+ type: object
+ properties:
+ description:
+ type: string
+ description: The description of the access package.
+ nullable: true
+ displayName:
+ type: string
+ description: The display name of the access package.
+ nullable: true
+ resourceRoleScopes:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageResourceRoleScope'
+ description: The resource role scopes associated with this available access package.
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ microsoft.graph.accessPackageSuggestionFilterByCurrentUserOptions:
+ title: accessPackageSuggestionFilterByCurrentUserOptions
+ enum:
+ - none
+ - relatedPeopleAssignments
+ - assignmentHistory
+ - unknownFutureValue
+ type: string
+ x-ms-enum-flags:
+ isFlags: true
microsoft.graph.accessPackageAssignmentRequest:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -71833,6 +73313,37 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.controlConfiguration:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: controlConfiguration
+ type: object
+ properties:
+ createdBy:
+ type: string
+ description: The userPrincipalName of the user or identity that created the control configuration.
+ nullable: true
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time the control configuration was created.
+ format: date-time
+ nullable: true
+ isEnabled:
+ type: boolean
+ description: Determines whether or not the control configuration is enabled.
+ modifiedBy:
+ type: string
+ description: The userPrincipalName of the user or identity that modified the control configuration.
+ nullable: true
+ modifiedDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time the control configuration was modified.
+ format: date-time
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessPackageResourceRequest:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -71947,7 +73458,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -71974,7 +73485,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -72121,7 +73632,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -72143,7 +73654,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -72176,7 +73687,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -72274,7 +73785,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -72531,7 +74042,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -72599,6 +74109,10 @@ components:
description: 'The date time when the workflow is expected to run next based on the schedule interval, if there are any users matching the execution conditions. Supports $filter(lt,gt) and $orderby.'
format: date-time
nullable: true
+ quarantineDetails:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.quarantineDetails'
+ settings:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflowSetting'
version:
maximum: 2147483647
minimum: -2147483648
@@ -72612,6 +74126,12 @@ components:
$ref: '#/components/schemas/microsoft.graph.identityGovernance.userProcessingResult'
description: The list of users that meet the workflowExecutionConditions of a workflow.
x-ms-navigationProperty: true
+ previewScope:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.directoryObject'
+ description: The preview scope for the workflow.
+ x-ms-navigationProperty: true
runs:
type: array
items:
@@ -72724,6 +74244,29 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.identityGovernance.cancelScope:
+ title: cancelScope
+ type: object
+ additionalProperties:
+ type: object
+ microsoft.graph.identityGovernance.previewFailedTask:
+ title: previewFailedTask
+ type: object
+ properties:
+ definitionId:
+ type: string
+ description: The identifier of the task definition of the task that failed during the preview operation of a workflow.
+ failureReason:
+ type: string
+ description: The reason why the task failed in the preview operation of a workflow.
+ name:
+ type: string
+ description: The name of the task that failed within the preview operation of a workflow.
+ taskId:
+ type: string
+ description: The identifier of the task that failed during the preview operation of a workflow.
+ additionalProperties:
+ type: object
microsoft.graph.identityGovernance.run:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -73116,6 +74659,8 @@ components:
- title: workflowVersion
type: object
properties:
+ settings:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.workflowSetting'
versionNumber:
maximum: 2147483647
minimum: -2147483648
@@ -73363,6 +74908,8 @@ components:
properties:
emailSettings:
$ref: '#/components/schemas/microsoft.graph.emailSettings'
+ quarantineConfiguration:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.quarantineConfiguration'
workflowScheduleIntervalInHours:
maximum: 2147483647
minimum: -2147483648
@@ -73521,6 +75068,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -73529,7 +75078,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -73592,6 +75141,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -73626,6 +75179,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -73703,11 +75258,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -73854,7 +75423,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.assignmentScheduleInstanceFilterByCurrentUserOptions:
title: assignmentScheduleInstanceFilterByCurrentUserOptions
enum:
@@ -75048,6 +76616,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.roleType:
+ title: roleType
+ enum:
+ - active
+ - eligible
+ - application
+ - delegated
+ - unknownFutureValue
+ type: string
microsoft.graph.accessPackageResourceAttribute:
title: accessPackageResourceAttribute
type: object
@@ -75078,6 +76655,11 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.accessPackageSuggestionReason:
+ title: accessPackageSuggestionReason
+ type: object
+ additionalProperties:
+ type: object
microsoft.graph.accessPackageAnswer:
title: accessPackageAnswer
type: object
@@ -77457,7 +79039,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -77893,6 +79474,32 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.identityGovernance.quarantineDetails:
+ title: quarantineDetails
+ type: object
+ properties:
+ quarantinedDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time when the workflow was quarantined.
+ format: date-time
+ nullable: true
+ quarantineReason:
+ type: string
+ description: The reason the workflow was quarantined.
+ nullable: true
+ quarantineType:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.quarantineType'
+ additionalProperties:
+ type: object
+ microsoft.graph.identityGovernance.workflowSetting:
+ title: workflowSetting
+ type: object
+ properties:
+ quarantineConfiguration:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.quarantineConfiguration'
+ additionalProperties:
+ type: object
microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus:
title: lifecycleWorkflowProcessingStatus
enum:
@@ -77903,6 +79510,8 @@ components:
- canceled
- failed
- unknownFutureValue
+ - canceling
+ - quarantined
type: string
microsoft.graph.identityGovernance.workflowExecutionType:
title: workflowExecutionType
@@ -77911,6 +79520,7 @@ components:
- onDemand
- unknownFutureValue
- activatedWithScope
+ - preview
type: string
microsoft.graph.identityGovernance.customTaskExtensionOperationStatus:
title: customTaskExtensionOperationStatus
@@ -77979,6 +79589,19 @@ components:
description: Specifies if the organization’s banner logo should be included in email notifications. The banner logo will replace the Microsoft logo at the top of the email notification. If true the banner logo will be taken from the tenant’s branding settings. This value can only be set to true if the organizationalBranding bannerLogo property is set.
additionalProperties:
type: object
+ microsoft.graph.identityGovernance.quarantineConfiguration:
+ title: quarantineConfiguration
+ type: object
+ properties:
+ conditions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.quarantineCondition'
+ description: The set of threshold conditions evaluated for the workflow. Each condition is either a countBasedQuarantineCondition or a percentageBasedQuarantineCondition.
+ matchMode:
+ $ref: '#/components/schemas/microsoft.graph.identityGovernance.matchMode'
+ additionalProperties:
+ type: object
microsoft.graph.identityGovernance.workflowExecutionConditions:
title: workflowExecutionConditions
type: object
@@ -78025,6 +79648,15 @@ components:
- group
- unknownFutureValue
type: string
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -78742,6 +80374,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.accessPackageSuggestionCollectionResponse:
+ title: Collection of accessPackageSuggestion
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestion'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessPackageAssignmentRequestCollectionResponse:
title: Collection of accessPackageAssignmentRequest
type: object
@@ -78768,6 +80413,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.availableAccessPackageCollectionResponse:
+ title: Collection of availableAccessPackage
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackage'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessPackageCatalogCollectionResponse:
title: Collection of accessPackageCatalog
type: object
@@ -78833,6 +80491,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.controlConfigurationCollectionResponse:
+ title: Collection of controlConfiguration
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.controlConfiguration'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.accessPackageResourceEnvironmentCollectionResponse:
title: Collection of accessPackageResourceEnvironment
type: object
@@ -79270,6 +80941,8 @@ components:
title: accessPackageApprovalStage
type: object
properties:
+ approverInformationVisibility:
+ $ref: '#/components/schemas/microsoft.graph.approverInformationVisibility'
durationBeforeAutomaticDenial:
pattern: '^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$'
type: string
@@ -79286,7 +80959,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.subjectSet'
- description: 'If escalation is enabled and the primary approvers do not respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests.'
+ description: 'If escalation is enabled and the primary approvers do not respond before the escalation time, the escalationApprovers are the users who are asked to approve requests.'
fallbackEscalationApprovers:
type: array
items:
@@ -79309,7 +80982,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.subjectSet'
- description: 'The subjects, typically users, who will be asked to approve requests. A collection of singleUser, groupMembers, requestorManager, internalSponsors, externalSponsors, or targetUserSponsors.'
+ description: 'The subjects, typically users, who are asked to approve requests. A collection of singleUser, groupMembers, requestorManager, internalSponsors, externalSponsors, or targetUserSponsors.'
additionalProperties:
type: object
microsoft.graph.accessReviewExpirationBehavior:
@@ -79377,6 +81050,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -80229,7 +81903,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -80245,13 +81919,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -80703,6 +82377,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -81314,7 +82993,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -81483,7 +83162,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -83438,6 +85117,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.identityGovernance.quarantineType:
+ title: quarantineType
+ enum:
+ - notQuarantined
+ - countBasedThresholdExceeded
+ - percentageBasedThresholdExceeded
+ - multipleConditionsExceeded
+ - unknownFutureValue
+ type: string
microsoft.graph.identityGovernance.valueType:
title: valueType
enum:
@@ -83447,6 +85135,18 @@ components:
- bool
- unknownFutureValue
type: string
+ microsoft.graph.identityGovernance.quarantineCondition:
+ title: quarantineCondition
+ type: object
+ additionalProperties:
+ type: object
+ microsoft.graph.identityGovernance.matchMode:
+ title: matchMode
+ enum:
+ - any
+ - all
+ - unknownFutureValue
+ type: string
microsoft.graph.settingValue:
title: settingValue
type: object
@@ -83623,6 +85323,14 @@ components:
$ref: '#/components/schemas/microsoft.graph.recurrenceRangeType'
additionalProperties:
type: object
+ microsoft.graph.approverInformationVisibility:
+ title: approverInformationVisibility
+ enum:
+ - default
+ - notVisible
+ - visible
+ - unknownFutureValue
+ type: string
microsoft.graph.printerBase:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -84979,6 +86687,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -92581,6 +94294,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.accessPackageResourceScopeCollectionResponse'
+ microsoft.graph.accessPackageSuggestionCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.accessPackageSuggestionCollectionResponse'
microsoft.graph.accessPackageAssignmentRequestCollectionResponse:
description: Retrieved collection
content:
@@ -92593,6 +94312,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.accessPackageAssignmentCollectionResponse'
+ microsoft.graph.availableAccessPackageCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.availableAccessPackageCollectionResponse'
microsoft.graph.accessPackageCatalogCollectionResponse:
description: Retrieved collection
content:
@@ -92623,6 +94348,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.directoryObjectCollectionResponse'
+ microsoft.graph.controlConfigurationCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.controlConfigurationCollectionResponse'
microsoft.graph.accessPackageResourceEnvironmentCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/v1.0/Identity.SignIns.yml b/openApiDocs/v1.0/Identity.SignIns.yml
index bf0d6b2a5d..1a71e901bc 100644
--- a/openApiDocs/v1.0/Identity.SignIns.yml
+++ b/openApiDocs/v1.0/Identity.SignIns.yml
@@ -5703,7 +5703,7 @@ paths:
tags:
- identity.conditionalAccessRoot
summary: Invoke function usage
- description: 'Allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that do not require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
+ description: 'Allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that don''t require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/authenticationstrengthpolicy-usage?view=graph-rest-1.0
@@ -10564,7 +10564,7 @@ paths:
tags:
- informationProtection.bitlocker
summary: List recoveryKeys
- description: 'Get a list of the bitlockerRecoveryKey objects and their properties. This operation does not return the key property. For information about how to read the key property, see Get bitlockerRecoveryKey. You can use this API to programmatically iterate through the list of recovery keys in the tenant and identify devices with BitLocker enabled. For more information, see the sample PowerShell code in BitLocker recovery process.'
+ description: 'Get a list of the bitlockerRecoveryKey objects and their properties. This operation doesn''t return the key property. For information about how to read the key property, see Get bitlockerRecoveryKey. You can use this API to programmatically iterate through the list of recovery keys in the tenant and identify devices with BitLocker enabled. For more information, see the sample PowerShell code in BitLocker recovery process.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/bitlocker-list-recoverykeys?view=graph-rest-1.0
@@ -13669,7 +13669,7 @@ paths:
tags:
- policies.authenticationStrengthPolicy
summary: Invoke function usage
- description: 'Allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that do not require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
+ description: 'Allows the caller to see which Conditional Access policies reference a specified authentication strength policy. The policies are returned in two collections, one containing Conditional Access policies that require an MFA claim and the other containing Conditional Access policies that don''t require such a claim. Policies in the former category are restricted in what kinds of changes may be made to them to prevent undermining the MFA requirement of those policies.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/authenticationstrengthpolicy-usage?view=graph-rest-1.0
@@ -15707,6 +15707,83 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /policies/federatedTokenValidationPolicy:
+ get:
+ tags:
+ - policies.federatedTokenValidationPolicy
+ summary: Get federatedTokenValidationPolicy from policies
+ operationId: policy_GetFederatedTokenValidationPolicy
+ parameters:
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.federatedTokenValidationPolicy'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - policies.federatedTokenValidationPolicy
+ summary: Update the navigation property federatedTokenValidationPolicy in policies
+ operationId: policy_UpdateFederatedTokenValidationPolicy
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.federatedTokenValidationPolicy'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.federatedTokenValidationPolicy'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - policies.federatedTokenValidationPolicy
+ summary: Delete navigation property federatedTokenValidationPolicy for policies
+ operationId: policy_DeleteFederatedTokenValidationPolicy
+ parameters:
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
/policies/homeRealmDiscoveryPolicies:
get:
tags:
@@ -22361,7 +22438,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Readonly.'
+ description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
description:
@@ -22378,7 +22455,7 @@ components:
modifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Readonly.'
+ description: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.'
format: date-time
nullable: true
sessionControls:
@@ -23100,7 +23177,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -23127,7 +23204,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -23274,7 +23351,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -23296,7 +23373,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -23329,7 +23406,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -23427,7 +23504,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -23684,7 +23761,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -23826,6 +23902,8 @@ components:
$ref: '#/components/schemas/microsoft.graph.featureRolloutPolicy'
description: The feature rollout policy associated with a directory object.
x-ms-navigationProperty: true
+ federatedTokenValidationPolicy:
+ $ref: '#/components/schemas/microsoft.graph.federatedTokenValidationPolicy'
homeRealmDiscoveryPolicies:
type: array
items:
@@ -24276,6 +24354,16 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.federatedTokenValidationPolicy:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.directoryObject'
+ - title: federatedTokenValidationPolicy
+ type: object
+ properties:
+ validatingDomains:
+ $ref: '#/components/schemas/microsoft.graph.validatingDomains'
+ additionalProperties:
+ type: object
microsoft.graph.homeRealmDiscoveryPolicy:
allOf:
- $ref: '#/components/schemas/microsoft.graph.stsPolicy'
@@ -28150,7 +28238,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -28882,6 +28969,14 @@ components:
- certificateBasedAuthentication
- multiFactorAuthentication
type: string
+ microsoft.graph.validatingDomains:
+ title: validatingDomains
+ type: object
+ properties:
+ rootDomains:
+ $ref: '#/components/schemas/microsoft.graph.rootDomains'
+ additionalProperties:
+ type: object
microsoft.graph.emailDetails:
title: emailDetails
type: object
@@ -30461,6 +30556,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -31086,7 +31182,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -31102,13 +31198,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -31560,6 +31656,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -32171,7 +32272,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -32261,6 +32362,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -32269,7 +32372,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -32332,6 +32435,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -32366,6 +32473,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -32443,11 +32552,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -32594,7 +32717,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -32680,7 +32802,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -34755,6 +34877,17 @@ components:
$ref: '#/components/schemas/microsoft.graph.deviceRegistrationMembership'
additionalProperties:
type: object
+ microsoft.graph.rootDomains:
+ title: rootDomains
+ enum:
+ - none
+ - all
+ - allFederated
+ - allManaged
+ - enumerated
+ - allManagedAndEnumeratedFederated
+ - unknownFutureValue
+ type: string
microsoft.graph.notifyMembers:
title: notifyMembers
enum:
@@ -36193,6 +36326,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -37154,6 +37292,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
diff --git a/openApiDocs/v1.0/Reports.yml b/openApiDocs/v1.0/Reports.yml
index 0096ee704f..81b2b9cc2b 100644
--- a/openApiDocs/v1.0/Reports.yml
+++ b/openApiDocs/v1.0/Reports.yml
@@ -155,7 +155,7 @@ paths:
tags:
- auditLogs.directoryAudit
summary: List directoryAudits
- description: 'Get the list of audit logs generated by Microsoft Entra ID. This includes audit logs generated by various services within Microsoft Entra ID, including user, app, device and group Management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (self-service and admin password resets), and self- service group management, and so on.'
+ description: 'Get a list of directoryAudit objects representing the audit logs generated by Microsoft Entra ID. This includes audit logs generated by various services within Microsoft Entra ID, including user, app, device and group Management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (self-service and admin password resets), and self- service group management, and so on.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/directoryaudit-list?view=graph-rest-1.0
@@ -232,7 +232,7 @@ paths:
tags:
- auditLogs.directoryAudit
summary: Get directoryAudit
- description: 'Get a specific Microsoft Entra audit log item. This includes an audit log item generated by various services within Microsoft Entra ID like user, application, device and group management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (self-service and admin password resets), self-service group management, and so on.'
+ description: 'Get a specific directoryAudit item. This includes an audit log item generated by various services within Microsoft Entra ID like user, application, device and group management, privileged identity management (PIM), access reviews, terms of use, identity protection, password management (self-service and admin password resets), self-service group management, and so on.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/directoryaudit-get?view=graph-rest-1.0
@@ -352,7 +352,7 @@ paths:
tags:
- auditLogs.provisioningObjectSummary
summary: List provisioningObjectSummary
- description: 'Get all provisioning events that occurred in your tenant, such as the deletion of a group in a target application or the creation of a user when provisioning user accounts from your HR system. '
+ description: 'Get all provisioningObjectSummary events that occurred in your tenant, such as the deletion of a group in a target application or the creation of a user when provisioning user accounts from your HR system. '
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/provisioningobjectsummary-list?view=graph-rest-1.0
diff --git a/openApiDocs/v1.0/SchemaExtensions.yml b/openApiDocs/v1.0/SchemaExtensions.yml
index b62150dac7..b19e4499b9 100644
--- a/openApiDocs/v1.0/SchemaExtensions.yml
+++ b/openApiDocs/v1.0/SchemaExtensions.yml
@@ -174,7 +174,7 @@ paths:
tags:
- schemaExtensions.schemaExtension
summary: Delete schemaExtension
- description: 'Delete the definition of a schema extension. Only the app that created the schema extension (owner app) can delete the schema extension definition, and only when the extension is in the InDevelopment state. Deleting a schema extension definition does not affect accessing custom data that has been added to resource instances based on that definition.'
+ description: 'Delete the definition of a schema extension. Only the app that created the schema extension (owner app) can delete the schema extension definition, and only when the extension is in the InDevelopment state. Deleting a schema extension definition doesn''t affect accessing custom data that has been added to resource instances based on that definition.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/schemaextension-delete?view=graph-rest-1.0
diff --git a/openApiDocs/v1.0/Search.yml b/openApiDocs/v1.0/Search.yml
index 590a7ae2d0..874ec28bef 100644
--- a/openApiDocs/v1.0/Search.yml
+++ b/openApiDocs/v1.0/Search.yml
@@ -3745,6 +3745,7 @@ components:
- personLanguages
- personPublications
- personPatents
+ - personWorkPositions
type: string
microsoft.graph.externalConnectors.propertyType:
title: propertyType
@@ -3917,6 +3918,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.externalConnectors.propertyRule:
title: propertyRule
type: object
diff --git a/openApiDocs/v1.0/Security.yml b/openApiDocs/v1.0/Security.yml
index 40b59efea7..7cf9404656 100644
--- a/openApiDocs/v1.0/Security.yml
+++ b/openApiDocs/v1.0/Security.yml
@@ -427,6 +427,10 @@ paths:
tags:
- security.alert
summary: Invoke action moveAlerts
+ description: Move one or more alert resources to a new or existing incident.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-alert-movealerts?view=graph-rest-1.0
operationId: security.alerts_v2_moveAlert
requestBody:
description: Action parameters
@@ -2685,7 +2689,7 @@ paths:
tags:
- security.attackSimulationRoot
summary: Update simulation
- description: Update an attack simulation campaign for a tenant.
+ description: Update an attack simulation campaign for a tenant. You can only update simulations that are in draft status.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/simulation-update?view=graph-rest-1.0
@@ -3338,12 +3342,12 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- /security/cases:
+ /security/auditLog:
get:
tags:
- - security.casesRoot
- summary: Get cases from security
- operationId: security_GetCase
+ - security.auditCoreRoot
+ summary: Get auditLog from security
+ operationId: security_GetAuditLog
parameters:
- name: $select
in: query
@@ -3371,21 +3375,21 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ $ref: '#/components/schemas/microsoft.graph.security.auditCoreRoot'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- - security.casesRoot
- summary: Update the navigation property cases in security
- operationId: security_UpdateCase
+ - security.auditCoreRoot
+ summary: Update the navigation property auditLog in security
+ operationId: security_UpdateAuditLog
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ $ref: '#/components/schemas/microsoft.graph.security.auditCoreRoot'
required: true
responses:
2XX:
@@ -3393,15 +3397,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ $ref: '#/components/schemas/microsoft.graph.security.auditCoreRoot'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- - security.casesRoot
- summary: Delete navigation property cases for security
- operationId: security_DeleteCase
+ - security.auditCoreRoot
+ summary: Delete navigation property auditLog for security
+ operationId: security_DeleteAuditLog
parameters:
- name: If-Match
in: header
@@ -3415,16 +3419,16 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- /security/cases/ediscoveryCases:
+ /security/auditLog/queries:
get:
tags:
- - security.casesRoot
- summary: List ediscoveryCases
- description: Get a list of the ediscoveryCase objects and their properties.
+ - security.auditCoreRoot
+ summary: List auditLogQueries
+ description: Get a list of auditLogQuery objects and their properties.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-casesroot-list-ediscoverycases?view=graph-rest-1.0
- operationId: security.case_ListEdiscoveryCase
+ url: https://learn.microsoft.com/graph/api/security-auditcoreroot-list-auditlogqueries?view=graph-rest-1.0
+ operationId: security.auditLog_ListQuery
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
@@ -3463,7 +3467,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.security.ediscoveryCaseCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.security.auditLogQueryCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -3472,19 +3476,19 @@ paths:
x-ms-docs-operation-type: operation
post:
tags:
- - security.casesRoot
- summary: Create ediscoveryCase
- description: Create a new ediscoveryCase object.
+ - security.auditCoreRoot
+ summary: Create auditLogQuery
+ description: Create a new auditLogQuery object.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-casesroot-post-ediscoverycases?view=graph-rest-1.0
- operationId: security.case_CreateEdiscoveryCase
+ url: https://learn.microsoft.com/graph/api/security-auditcoreroot-post-auditlogqueries?view=graph-rest-1.0
+ operationId: security.auditLog_CreateQuery
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQuery'
required: true
responses:
2XX:
@@ -3492,29 +3496,29 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQuery'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/security/cases/ediscoveryCases/{ediscoveryCase-id}':
+ '/security/auditLog/queries/{auditLogQuery-id}':
get:
tags:
- - security.casesRoot
- summary: Get ediscoveryCase
- description: Read the properties and relationships of an ediscoveryCase object.
+ - security.auditCoreRoot
+ summary: Get auditLogQuery
+ description: Read the properties and relationships of an auditLogQuery object.
externalDocs:
description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycase-get?view=graph-rest-1.0
- operationId: security.case_GetEdiscoveryCase
+ url: https://learn.microsoft.com/graph/api/security-auditlogquery-get?view=graph-rest-1.0
+ operationId: security.auditLog_GetQuery
parameters:
- - name: ediscoveryCase-id
+ - name: auditLogQuery-id
in: path
- description: The unique identifier of ediscoveryCase
+ description: The unique identifier of auditLogQuery
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCase
+ x-ms-docs-key-type: auditLogQuery
- name: $select
in: query
description: Select properties to be returned
@@ -3541,63 +3545,24 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
- tags:
- - security.casesRoot
- summary: Update ediscoveryCase
- description: Update the properties of an ediscoveryCase object.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycase-update?view=graph-rest-1.0
- operationId: security.case_UpdateEdiscoveryCase
- parameters:
- - name: ediscoveryCase-id
- in: path
- description: The unique identifier of ediscoveryCase
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCase
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
- required: true
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQuery'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- - security.casesRoot
- summary: Delete ediscoveryCase
- description: Delete an ediscoveryCase object.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-casesroot-delete-ediscoverycases?view=graph-rest-1.0
- operationId: security.case_DeleteEdiscoveryCase
+ - security.auditCoreRoot
+ summary: Delete navigation property queries for security
+ operationId: security.auditLog_DeleteQuery
parameters:
- - name: ediscoveryCase-id
+ - name: auditLogQuery-id
in: path
- description: The unique identifier of ediscoveryCase
+ description: The unique identifier of auditLogQuery
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCase
+ x-ms-docs-key-type: auditLogQuery
- name: If-Match
in: header
description: ETag
@@ -3610,25 +3575,22 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers':
+ '/security/auditLog/queries/{auditLogQuery-id}/records':
get:
tags:
- - security.casesRoot
- summary: List ediscoveryCaseMember objects
- description: Get a list of ediscoveryCaseMember objects for an ediscoveryCase.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-list?view=graph-rest-1.0
- operationId: security.case.ediscoveryCase_ListCaseMember
+ - security.auditCoreRoot
+ summary: Get records from security
+ description: An individual audit log record.
+ operationId: security.auditLog.query_ListRecord
parameters:
- - name: ediscoveryCase-id
+ - name: auditLogQuery-id
in: path
- description: The unique identifier of ediscoveryCase
+ description: The unique identifier of auditLogQuery
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCase
+ x-ms-docs-key-type: auditLogQuery
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -3666,72 +3628,37 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.security.ediscoveryCaseMemberCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.security.auditLogRecordCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
- post:
- tags:
- - security.casesRoot
- summary: Add ediscoveryCaseMember
- description: 'Add an ediscoveryCaseMember to an ediscoveryCase. The ediscoveryCaseMember can be one of two types: a user or a role group.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-post?view=graph-rest-1.0
- operationId: security.case.ediscoveryCase_CreateCaseMember
- parameters:
- - name: ediscoveryCase-id
- in: path
- description: The unique identifier of ediscoveryCase
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCase
- requestBody:
- description: New navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
- required: true
- responses:
- 2XX:
- description: Created navigation property.
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers/{ediscoveryCaseMember-id}':
+ '/security/auditLog/queries/{auditLogQuery-id}/records/{auditLogRecord-id}':
get:
tags:
- - security.casesRoot
- summary: Get caseMembers from security
- description: Represents members of an eDiscovery case.
- operationId: security.case.ediscoveryCase_GetCaseMember
+ - security.auditCoreRoot
+ summary: Get records from security
+ description: An individual audit log record.
+ operationId: security.auditLog.query_GetRecord
parameters:
- - name: ediscoveryCase-id
+ - name: auditLogQuery-id
in: path
- description: The unique identifier of ediscoveryCase
+ description: The unique identifier of auditLogQuery
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCase
- - name: ediscoveryCaseMember-id
+ x-ms-docs-key-type: auditLogQuery
+ - name: auditLogRecord-id
in: path
- description: The unique identifier of ediscoveryCaseMember
+ description: The unique identifier of auditLogRecord
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCaseMember
+ x-ms-docs-key-type: auditLogRecord
- name: $select
in: query
description: Select properties to be returned
@@ -3758,102 +3685,39 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecord'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- patch:
- tags:
- - security.casesRoot
- summary: Update the navigation property caseMembers in security
- operationId: security.case.ediscoveryCase_UpdateCaseMember
- parameters:
- - name: ediscoveryCase-id
- in: path
- description: The unique identifier of ediscoveryCase
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCase
- - name: ediscoveryCaseMember-id
- in: path
- description: The unique identifier of ediscoveryCaseMember
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCaseMember
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
- required: true
- responses:
- 2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ '/security/auditLog/queries/{auditLogQuery-id}/records/$count':
+ get:
tags:
- - security.casesRoot
- summary: Remove ediscoveryCaseMember
- description: Remove an ediscoveryCaseMember from an ediscoveryCase.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-delete?view=graph-rest-1.0
- operationId: security.case.ediscoveryCase_DeleteCaseMember
+ - security.auditCoreRoot
+ summary: Get the number of the resource
+ operationId: security.auditLog.query.record_GetCount
parameters:
- - name: ediscoveryCase-id
+ - name: auditLogQuery-id
in: path
- description: The unique identifier of ediscoveryCase
+ description: The unique identifier of auditLogQuery
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: ediscoveryCase
- - name: ediscoveryCaseMember-id
- in: path
- description: The unique identifier of ediscoveryCaseMember
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCaseMember
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ x-ms-docs-key-type: auditLogQuery
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Success
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers/$count':
+ /security/auditLog/queries/$count:
get:
tags:
- - security.casesRoot
+ - security.auditCoreRoot
summary: Get the number of the resource
- operationId: security.case.ediscoveryCase.caseMember_GetCount
+ operationId: security.auditLog.query_GetCount
parameters:
- - name: ediscoveryCase-id
- in: path
- description: The unique identifier of ediscoveryCase
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCase
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -3861,40 +3725,563 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/security/cases/ediscoveryCases/{ediscoveryCase-id}/custodians':
+ /security/cases:
get:
tags:
- security.casesRoot
- summary: List ediscoveryCustodian
- description: Get a list of the custodian objects and their properties.
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/security-ediscoverycase-list-custodians?view=graph-rest-1.0
- operationId: security.case.ediscoveryCase_ListCustodian
+ summary: Get cases from security
+ operationId: security_GetCase
parameters:
- - name: ediscoveryCase-id
- in: path
- description: The unique identifier of ediscoveryCase
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: ediscoveryCase
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- - $ref: '#/components/parameters/count'
- - name: $orderby
- in: query
- description: Order items by property values
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - security.casesRoot
+ summary: Update the navigation property cases in security
+ operationId: security_UpdateCase
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - security.casesRoot
+ summary: Delete navigation property cases for security
+ operationId: security_DeleteCase
+ parameters:
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /security/cases/ediscoveryCases:
+ get:
+ tags:
+ - security.casesRoot
+ summary: List ediscoveryCases
+ description: Get a list of the ediscoveryCase objects and their properties.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-casesroot-list-ediscoverycases?view=graph-rest-1.0
+ operationId: security.case_ListEdiscoveryCase
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.security.ediscoveryCaseCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - security.casesRoot
+ summary: Create ediscoveryCase
+ description: Create a new ediscoveryCase object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-casesroot-post-ediscoverycases?view=graph-rest-1.0
+ operationId: security.case_CreateEdiscoveryCase
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/security/cases/ediscoveryCases/{ediscoveryCase-id}':
+ get:
+ tags:
+ - security.casesRoot
+ summary: Get ediscoveryCase
+ description: Read the properties and relationships of an ediscoveryCase object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycase-get?view=graph-rest-1.0
+ operationId: security.case_GetEdiscoveryCase
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - security.casesRoot
+ summary: Update ediscoveryCase
+ description: Update the properties of an ediscoveryCase object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycase-update?view=graph-rest-1.0
+ operationId: security.case_UpdateEdiscoveryCase
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCase'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - security.casesRoot
+ summary: Delete ediscoveryCase
+ description: Delete an ediscoveryCase object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-casesroot-delete-ediscoverycases?view=graph-rest-1.0
+ operationId: security.case_DeleteEdiscoveryCase
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers':
+ get:
+ tags:
+ - security.casesRoot
+ summary: List ediscoveryCaseMember objects
+ description: Get a list of ediscoveryCaseMember objects for an ediscoveryCase.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-list?view=graph-rest-1.0
+ operationId: security.case.ediscoveryCase_ListCaseMember
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.security.ediscoveryCaseMemberCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - security.casesRoot
+ summary: Add ediscoveryCaseMember
+ description: 'Add an ediscoveryCaseMember to an ediscoveryCase. The ediscoveryCaseMember can be one of two types: a user or a role group.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-post?view=graph-rest-1.0
+ operationId: security.case.ediscoveryCase_CreateCaseMember
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers/{ediscoveryCaseMember-id}':
+ get:
+ tags:
+ - security.casesRoot
+ summary: Get caseMembers from security
+ description: Represents members of an eDiscovery case.
+ operationId: security.case.ediscoveryCase_GetCaseMember
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - name: ediscoveryCaseMember-id
+ in: path
+ description: The unique identifier of ediscoveryCaseMember
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCaseMember
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - security.casesRoot
+ summary: Update the navigation property caseMembers in security
+ operationId: security.case.ediscoveryCase_UpdateCaseMember
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - name: ediscoveryCaseMember-id
+ in: path
+ description: The unique identifier of ediscoveryCaseMember
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCaseMember
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.ediscoveryCaseMember'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - security.casesRoot
+ summary: Remove ediscoveryCaseMember
+ description: Remove an ediscoveryCaseMember from an ediscoveryCase.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycasemember-delete?view=graph-rest-1.0
+ operationId: security.case.ediscoveryCase_DeleteCaseMember
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - name: ediscoveryCaseMember-id
+ in: path
+ description: The unique identifier of ediscoveryCaseMember
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCaseMember
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/security/cases/ediscoveryCases/{ediscoveryCase-id}/caseMembers/$count':
+ get:
+ tags:
+ - security.casesRoot
+ summary: Get the number of the resource
+ operationId: security.case.ediscoveryCase.caseMember_GetCount
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/security/cases/ediscoveryCases/{ediscoveryCase-id}/custodians':
+ get:
+ tags:
+ - security.casesRoot
+ summary: List ediscoveryCustodian
+ description: Get a list of the custodian objects and their properties.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycase-list-custodians?view=graph-rest-1.0
+ operationId: security.case.ediscoveryCase_ListCustodian
+ parameters:
+ - name: ediscoveryCase-id
+ in: path
+ description: The unique identifier of ediscoveryCase
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: ediscoveryCase
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
- name: $select
in: query
description: Select properties to be returned
@@ -5472,6 +5859,9 @@ paths:
tags:
- security.casesRoot
summary: Invoke action applyHold
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycustodian-applyhold?view=graph-rest-1.0
operationId: security.case.ediscoveryCase.custodian_applyHold
parameters:
- name: ediscoveryCase-id
@@ -5508,6 +5898,9 @@ paths:
tags:
- security.casesRoot
summary: Invoke action removeHold
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverycustodian-removehold?view=graph-rest-1.0
operationId: security.case.ediscoveryCase.custodian_removeHold
parameters:
- name: ediscoveryCase-id
@@ -6151,6 +6544,9 @@ paths:
tags:
- security.casesRoot
summary: Invoke action applyHold
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverynoncustodialdatasource-applyhold?view=graph-rest-1.0
operationId: security.case.ediscoveryCase.noncustodialDataSource_applyHold
parameters:
- name: ediscoveryCase-id
@@ -6187,6 +6583,9 @@ paths:
tags:
- security.casesRoot
summary: Invoke action removeHold
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoverynoncustodialdatasource-removehold?view=graph-rest-1.0
operationId: security.case.ediscoveryCase.noncustodialDataSource_removeHold
parameters:
- name: ediscoveryCase-id
@@ -9053,6 +9452,9 @@ paths:
- security.casesRoot
summary: Invoke function asHierarchy
description: List eDiscovery review tags with the tag hierarchy shown.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-ediscoveryreviewtag-ashierarchy?view=graph-rest-1.0
operationId: security.case.ediscoveryCase.tag_asHierarchy
parameters:
- name: ediscoveryCase-id
@@ -9136,6 +9538,324 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ /security/collaboration:
+ get:
+ tags:
+ - security.collaborationRoot
+ summary: Get collaboration from security
+ operationId: security_GetCollaboration
+ parameters:
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.collaborationRoot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - security.collaborationRoot
+ summary: Update the navigation property collaboration in security
+ operationId: security_UpdateCollaboration
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.collaborationRoot'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.collaborationRoot'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - security.collaborationRoot
+ summary: Delete navigation property collaboration for security
+ operationId: security_DeleteCollaboration
+ parameters:
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /security/collaboration/analyzedEmails:
+ get:
+ tags:
+ - security.collaborationRoot
+ summary: List analyzedEmails
+ description: 'Get a list of analyzedEmail objects and their properties. This API allows Security Operations teams to have direct access to hunt (query) for threats, IOCs, attack vectors, and evidences for a tenant. It is a powerful, near real-time tool to help Security Operations teams investigate and respond to threats. It consists of email metadata, verdict information, related underlying entities (attachments/URL), filters, and more.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-collaborationroot-list-analyzedemails?view=graph-rest-1.0
+ operationId: security.collaboration_ListAnalyzedEmail
+ parameters:
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.security.analyzedEmailCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - security.collaborationRoot
+ summary: Create new navigation property to analyzedEmails for security
+ operationId: security.collaboration_CreateAnalyzedEmail
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/security/collaboration/analyzedEmails/{analyzedEmail-id}':
+ get:
+ tags:
+ - security.collaborationRoot
+ summary: Get analyzedEmail
+ description: Read the properties and relationships of an analyzedEmail object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-analyzedemail-get?view=graph-rest-1.0
+ operationId: security.collaboration_GetAnalyzedEmail
+ parameters:
+ - name: analyzedEmail-id
+ in: path
+ description: The unique identifier of analyzedEmail
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: analyzedEmail
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - security.collaborationRoot
+ summary: Update the navigation property analyzedEmails in security
+ operationId: security.collaboration_UpdateAnalyzedEmail
+ parameters:
+ - name: analyzedEmail-id
+ in: path
+ description: The unique identifier of analyzedEmail
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: analyzedEmail
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - security.collaborationRoot
+ summary: Delete navigation property analyzedEmails for security
+ operationId: security.collaboration_DeleteAnalyzedEmail
+ parameters:
+ - name: analyzedEmail-id
+ in: path
+ description: The unique identifier of analyzedEmail
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: analyzedEmail
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ /security/collaboration/analyzedEmails/$count:
+ get:
+ tags:
+ - security.collaborationRoot
+ summary: Get the number of the resource
+ operationId: security.collaboration.analyzedEmail_GetCount
+ parameters:
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ /security/collaboration/analyzedEmails/microsoft.graph.security.remediate:
+ post:
+ tags:
+ - security.collaborationRoot
+ summary: Invoke action remediate
+ description: 'Remove a potential threat from end users'' mailboxes. Remediation means to take prescribed action against a threat. This API can trigger email purge actions like move to junk, move to deleted items, soft delete, hard delete, or move to Inbox. This API enables scenarios and use cases such as SOAR integration, playbooks, and automations. For more information read email remediation, trigger action and track actions. If there is false positives admins can take move to inbox action.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-analyzedemail-remediate?view=graph-rest-1.0
+ operationId: security.collaboration.analyzedEmail_remediate
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ displayName:
+ type: string
+ nullable: true
+ description:
+ type: string
+ nullable: true
+ severity:
+ $ref: '#/components/schemas/microsoft.graph.security.remediationSeverity'
+ action:
+ $ref: '#/components/schemas/microsoft.graph.security.remediationAction'
+ remediateSendersCopy:
+ type: boolean
+ default: false
+ nullable: true
+ analyzedEmails:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
/security/dataSecurityAndGovernance:
get:
tags:
@@ -10923,6 +11643,9 @@ paths:
- security.identityContainer
summary: Invoke action activate
description: Activate Microsoft Defender for Identity sensors.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-sensorcandidate-activate?view=graph-rest-1.0
operationId: security.identity.sensorCandidate_activate
requestBody:
description: Action parameters
@@ -11292,6 +12015,9 @@ paths:
- security.identityContainer
summary: Invoke function getDeploymentAccessKey
description: Get the deployment access key for Microsoft Defender for Identity that is required to install sensors associated with the workspace.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-sensor-getdeploymentaccesskey?view=graph-rest-1.0
operationId: security.identity.sensor_getDeploymentAccessKey
responses:
2XX:
@@ -11309,6 +12035,9 @@ paths:
- security.identityContainer
summary: Invoke function getDeploymentPackageUri
description: Get the sensor deployment package URL and version. You can use this URL to download the installer to install the sensor on a server.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-sensor-getdeploymentpackageuri?view=graph-rest-1.0
operationId: security.identity.sensor_getDeploymentPackageUri
responses:
2XX:
@@ -11326,6 +12055,9 @@ paths:
- security.identityContainer
summary: Invoke action regenerateDeploymentAccessKey
description: Generate a new deployment access key that can be used to install a sensor associated with the workspace.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-sensor-regeneratedeploymentaccesskey?view=graph-rest-1.0
operationId: security.identity.sensor_regenerateDeploymentAccessKey
responses:
2XX:
@@ -11921,6 +12653,10 @@ paths:
tags:
- security.incident
summary: Invoke action mergeIncidents
+ description: Merge multiple incident resources into a single incident.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-incident-mergeincidents?view=graph-rest-1.0
operationId: security.incident_mergeIncident
requestBody:
description: Action parameters
@@ -13389,8 +14125,11 @@ paths:
get:
tags:
- security.labelsRoot
- summary: Get retentionLabels from security
- description: 'Represents how customers can manage their data, whether and for how long to retain or delete it.'
+ summary: Get retentionLabel
+ description: Read the properties and relationships of a retentionLabel object.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/security-retentionlabel-get?view=graph-rest-1.0
operationId: security.label_GetRetentionLabel
parameters:
- name: retentionLabel-id
@@ -23233,8 +23972,12 @@ components:
x-ms-navigationProperty: true
attackSimulation:
$ref: '#/components/schemas/microsoft.graph.attackSimulationRoot'
+ auditLog:
+ $ref: '#/components/schemas/microsoft.graph.security.auditCoreRoot'
cases:
$ref: '#/components/schemas/microsoft.graph.security.casesRoot'
+ collaboration:
+ $ref: '#/components/schemas/microsoft.graph.security.collaborationRoot'
dataSecurityAndGovernance:
$ref: '#/components/schemas/microsoft.graph.tenantDataSecurityAndGovernance'
identities:
@@ -23270,6 +24013,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.security.triggerTypesRoot'
additionalProperties:
type: object
+ description: Security singleton providing access to audit log resources.
microsoft.graph.alert:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -23657,6 +24401,7 @@ components:
properties:
targetIncidentId:
type: string
+ description: The ID of the target incident after the operation completes.
additionalProperties:
type: object
microsoft.graph.attackSimulationRoot:
@@ -24276,6 +25021,152 @@ components:
description: Content locale for the training detail.
additionalProperties:
type: object
+ microsoft.graph.security.auditCoreRoot:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: auditCoreRoot
+ type: object
+ properties:
+ queries:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQuery'
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ description: Root entity for the audit log API.
+ microsoft.graph.security.auditLogQuery:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: auditLogQuery
+ type: object
+ properties:
+ administrativeUnitIdFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The administrative units tagged to an audit log record.
+ displayName:
+ type: string
+ description: The display name of the saved audit log query.
+ nullable: true
+ filterEndDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The end date of the date range in the query.
+ format: date-time
+ nullable: true
+ filterStartDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The start date of the date range in the query.
+ format: date-time
+ nullable: true
+ ipAddressFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The IP address of the device that was used when the activity was logged.
+ keywordFilter:
+ type: string
+ description: Free text field to search non-indexed properties of the audit log.
+ nullable: true
+ objectIdFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: 'For SharePoint and OneDrive for Business activity, the full path name of the file or folder accessed by the user. For Exchange admin audit logging, the name of the object that was modified by the cmdlet.'
+ operationFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: 'The name of the user or admin activity. For a description of the most common operations/activities, see Search the audit log in the Office 365 Protection Center.'
+ recordTypeFilters:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecordType'
+ description: 'The type of operation indicated by the record. For the list of member values, see auditLogRecordType.'
+ serviceFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ status:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQueryStatus'
+ userPrincipalNameFilters:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: 'The UPN (user principal name) of the user who performed the action (specified in the operation property) that resulted in the record being logged; for example, myname@mydomain_name.'
+ records:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecord'
+ description: An individual audit log record.
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ description: Represents a query against the unified audit log.
+ microsoft.graph.security.auditLogRecord:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: auditLogRecord
+ type: object
+ properties:
+ administrativeUnits:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The administrative units tagged to an audit log record.
+ auditData:
+ $ref: '#/components/schemas/microsoft.graph.security.auditData'
+ auditLogRecordType:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecordType'
+ clientIp:
+ type: string
+ description: The IP address of the device used when the activity was logged. The IP address is displayed in either an IPv4 or IPv6 address format.
+ nullable: true
+ createdDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time in UTC when the user performed the activity.
+ format: date-time
+ nullable: true
+ objectId:
+ type: string
+ description: 'For Exchange admin audit logging, the name of the object modified by the cmdlet. For SharePoint activity, the full URL path name of the file or folder accessed by a user. For Microsoft Entra activity, the name of the user account that was modified.'
+ nullable: true
+ operation:
+ type: string
+ description: The name of the user or admin activity.
+ nullable: true
+ organizationId:
+ type: string
+ description: The GUID for your organization.
+ nullable: true
+ service:
+ type: string
+ description: The Microsoft 365 service where the activity occurred.
+ nullable: true
+ userId:
+ type: string
+ description: 'The user who performed the action (specified in the Operation property) that resulted in the record being logged. Audit records for activity performed by system accounts (such as SHAREPOINT/system or NT AUTHORITY/SYSTEM) are also included in the audit log. Another common value for the UserId property is app@sharepoint. It indicates that the ''user'' who performed the activity was an application with the necessary permissions in SharePoint to perform organization-wide actions (such as searching a SharePoint site or OneDrive account) on behalf of a user, admin, or service.'
+ nullable: true
+ userPrincipalName:
+ type: string
+ description: UPN of the user who performed the action.
+ nullable: true
+ userType:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogUserType'
+ additionalProperties:
+ type: object
+ description: Represents an individual audit log record.
microsoft.graph.security.casesRoot:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -24541,6 +25432,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -24549,7 +25442,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -24612,6 +25505,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -24646,6 +25543,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -24723,11 +25622,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -24874,7 +25787,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.security.userSource:
allOf:
- $ref: '#/components/schemas/microsoft.graph.security.dataSource'
@@ -25019,6 +25931,7 @@ components:
- messageConversationExpansion
- locationsWithoutHits
- allItemsInFolder
+ - cloudNativeHtmlConversion
type: string
x-ms-enum-flags:
isFlags: true
@@ -25255,6 +26168,203 @@ components:
$ref: '#/components/schemas/microsoft.graph.security.topicModelingSettings'
additionalProperties:
type: object
+ microsoft.graph.security.collaborationRoot:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: collaborationRoot
+ type: object
+ properties:
+ analyzedEmails:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ description: Contains metadata for analyzed emails.
+ x-ms-navigationProperty: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmail:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: analyzedEmail
+ type: object
+ properties:
+ alertIds:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: A collection of values that contain the IDs of any alerts associated with the email.
+ attachments:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailAttachment'
+ description: A collection of the attachments in the email.
+ authenticationDetails:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailAuthenticationDetail'
+ bulkComplaintLevel:
+ type: string
+ description: The bulk complaint level of the email. A higher level is more likely to be spam.
+ nullable: true
+ clientType:
+ type: string
+ description: 'Shows the type of client that sent the message (for example, REST).'
+ nullable: true
+ contexts:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: Provides context of the email.
+ detectionMethods:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The methods of detection used.
+ directionality:
+ $ref: '#/components/schemas/microsoft.graph.security.antispamDirectionality'
+ distributionList:
+ type: string
+ description: The distribution list details to which the email was sent.
+ nullable: true
+ dlpRules:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailDlpRuleInfo'
+ description: Data loss prevention rules configured in purview.
+ emailClusterId:
+ type: string
+ description: The identifier for the group of similar emails clustered based on heuristic analysis of their content.
+ nullable: true
+ exchangeTransportRules:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailExchangeTransportRuleInfo'
+ description: The name of the Exchange transport rules (ETRs) associated with the email.
+ forwardingDetail:
+ type: string
+ description: Email smtp forwarding details.
+ nullable: true
+ inboundConnectorFormattedName:
+ type: string
+ description: Custom instructions name that defines organizational mail flow and how the email was routed.
+ nullable: true
+ internetMessageId:
+ type: string
+ description: A public-facing identifier for the email that is sent. The message ID is in the format specified by RFC2822.
+ nullable: true
+ language:
+ type: string
+ description: The detected language of the email content.
+ nullable: true
+ latestDelivery:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailDeliveryDetail'
+ loggedDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: Date-time when the email record was logged.
+ format: date-time
+ nullable: true
+ networkMessageId:
+ type: string
+ description: An internal identifier for the email generated by Microsoft 365.
+ nullable: true
+ originalDelivery:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailDeliveryDetail'
+ overrideSources:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: An aggregated list of all overrides with source on email.
+ phishConfidenceLevel:
+ type: string
+ description: The phish confidence level associated with the email
+ nullable: true
+ policy:
+ type: string
+ description: The action policy that took effect.
+ nullable: true
+ policyAction:
+ type: string
+ description: The action taken on the email based on the configured policy.
+ nullable: true
+ policyType:
+ type: string
+ description: Type of policy configured that defines the delivery action on email.
+ nullable: true
+ primaryOverrideSource:
+ type: string
+ description: 'Shows the organization or user setting that altered the intended delivery location of the message (allowed instead of blocked, or blocked instead of allowed).'
+ nullable: true
+ recipientDetail:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailRecipientDetail'
+ recipientEmailAddress:
+ type: string
+ description: Contains the email address of the recipient.
+ nullable: true
+ returnPath:
+ type: string
+ description: A field that indicates where and how bounced emails are processed.
+ nullable: true
+ senderDetail:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailSenderDetail'
+ sizeInBytes:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: Size of the email in bytes.
+ format: int32
+ nullable: true
+ spamConfidenceLevel:
+ type: string
+ description: Spam confidence of the email.
+ nullable: true
+ subject:
+ type: string
+ description: Subject of the email.
+ nullable: true
+ threatDetectionDetails:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.threatDetectionDetail'
+ description: Information about threats detected in the email.
+ threatTypes:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.threatType'
+ description: 'Indicates the threat types. The possible values are: unknown, spam, malware, phish, none, unknownFutureValue.'
+ timelineEvents:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.timelineEvent'
+ description: Delivery and post-delivery events that happened to the email.
+ urls:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailUrl'
+ description: A collection of the URLs in the email.
+ additionalProperties:
+ type: object
+ microsoft.graph.security.remediationSeverity:
+ title: remediationSeverity
+ enum:
+ - low
+ - medium
+ - high
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.remediationAction:
+ title: remediationAction
+ enum:
+ - moveToJunk
+ - moveToInbox
+ - hardDelete
+ - softDelete
+ - moveToDeletedItems
+ - unknownFutureValue
+ - moveToQuarantine
+ type: string
microsoft.graph.tenantDataSecurityAndGovernance:
allOf:
- $ref: '#/components/schemas/microsoft.graph.dataSecurityAndGovernance'
@@ -26390,7 +27500,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -26417,7 +27527,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -26564,7 +27674,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -26586,7 +27696,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -26619,7 +27729,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -26717,7 +27827,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -26974,7 +28084,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -28700,6 +29809,7 @@ components:
- microsoftSentinel
- microsoftInsiderRiskManagement
- microsoftThreatIntelligence
+ - microsoftSecurityForAI
type: string
microsoft.graph.security.alertSeverity:
title: alertSeverity
@@ -29055,6 +30165,520 @@ components:
- phishing
- unknownFutureValue
type: string
+ microsoft.graph.security.auditLogRecordType:
+ title: auditLogRecordType
+ enum:
+ - ExchangeAdmin
+ - ExchangeItem
+ - ExchangeItemGroup
+ - SharePoint
+ - SyntheticProbe
+ - SharePointFileOperation
+ - OneDrive
+ - AzureActiveDirectory
+ - AzureActiveDirectoryAccountLogon
+ - DataCenterSecurityCmdlet
+ - ComplianceDLPSharePoint
+ - Sway
+ - ComplianceDLPExchange
+ - SharePointSharingOperation
+ - AzureActiveDirectoryStsLogon
+ - SkypeForBusinessPSTNUsage
+ - SkypeForBusinessUsersBlocked
+ - SecurityComplianceCenterEOPCmdlet
+ - ExchangeAggregatedOperation
+ - PowerBIAudit
+ - CRM
+ - Yammer
+ - SkypeForBusinessCmdlets
+ - Discovery
+ - MicrosoftTeams
+ - ThreatIntelligence
+ - MailSubmission
+ - MicrosoftFlow
+ - AeD
+ - MicrosoftStream
+ - ComplianceDLPSharePointClassification
+ - ThreatFinder
+ - Project
+ - SharePointListOperation
+ - SharePointCommentOperation
+ - DataGovernance
+ - Kaizala
+ - SecurityComplianceAlerts
+ - ThreatIntelligenceUrl
+ - SecurityComplianceInsights
+ - MIPLabel
+ - WorkplaceAnalytics
+ - PowerAppsApp
+ - PowerAppsPlan
+ - ThreatIntelligenceAtpContent
+ - LabelContentExplorer
+ - TeamsHealthcare
+ - ExchangeItemAggregated
+ - HygieneEvent
+ - DataInsightsRestApiAudit
+ - InformationBarrierPolicyApplication
+ - SharePointListItemOperation
+ - SharePointContentTypeOperation
+ - SharePointFieldOperation
+ - MicrosoftTeamsAdmin
+ - HRSignal
+ - MicrosoftTeamsDevice
+ - MicrosoftTeamsAnalytics
+ - InformationWorkerProtection
+ - Campaign
+ - DLPEndpoint
+ - AirInvestigation
+ - Quarantine
+ - MicrosoftForms
+ - ApplicationAudit
+ - ComplianceSupervisionExchange
+ - CustomerKeyServiceEncryption
+ - OfficeNative
+ - MipAutoLabelSharePointItem
+ - MipAutoLabelSharePointPolicyLocation
+ - MicrosoftTeamsShifts
+ - SecureScore
+ - MipAutoLabelExchangeItem
+ - CortanaBriefing
+ - Search
+ - WDATPAlerts
+ - PowerPlatformAdminDlp
+ - PowerPlatformAdminEnvironment
+ - MDATPAudit
+ - SensitivityLabelPolicyMatch
+ - SensitivityLabelAction
+ - SensitivityLabeledFileAction
+ - AttackSim
+ - AirManualInvestigation
+ - SecurityComplianceRBAC
+ - UserTraining
+ - AirAdminActionInvestigation
+ - MSTIC
+ - PhysicalBadgingSignal
+ - TeamsEasyApprovals
+ - AipDiscover
+ - AipSensitivityLabelAction
+ - AipProtectionAction
+ - AipFileDeleted
+ - AipHeartBeat
+ - MCASAlerts
+ - OnPremisesFileShareScannerDlp
+ - OnPremisesSharePointScannerDlp
+ - ExchangeSearch
+ - SharePointSearch
+ - PrivacyDataMinimization
+ - LabelAnalyticsAggregate
+ - MyAnalyticsSettings
+ - SecurityComplianceUserChange
+ - ComplianceDLPExchangeClassification
+ - ComplianceDLPEndpoint
+ - MipExactDataMatch
+ - MSDEResponseActions
+ - MSDEGeneralSettings
+ - MSDEIndicatorsSettings
+ - MS365DCustomDetection
+ - MSDERolesSettings
+ - MAPGAlerts
+ - MAPGPolicy
+ - MAPGRemediation
+ - PrivacyRemediationAction
+ - PrivacyDigestEmail
+ - MipAutoLabelSimulationProgress
+ - MipAutoLabelSimulationCompletion
+ - MipAutoLabelProgressFeedback
+ - DlpSensitiveInformationType
+ - MipAutoLabelSimulationStatistics
+ - LargeContentMetadata
+ - Microsoft365Group
+ - CDPMlInferencingResult
+ - FilteringMailMetadata
+ - CDPClassificationMailItem
+ - CDPClassificationDocument
+ - OfficeScriptsRunAction
+ - FilteringPostMailDeliveryAction
+ - CDPUnifiedFeedback
+ - TenantAllowBlockList
+ - ConsumptionResource
+ - HealthcareSignal
+ - DlpImportResult
+ - CDPCompliancePolicyExecution
+ - MultiStageDisposition
+ - PrivacyDataMatch
+ - FilteringDocMetadata
+ - FilteringEmailFeatures
+ - PowerBIDlp
+ - FilteringUrlInfo
+ - FilteringAttachmentInfo
+ - CoreReportingSettings
+ - ComplianceConnector
+ - PowerPlatformLockboxResourceAccessRequest
+ - PowerPlatformLockboxResourceCommand
+ - CDPPredictiveCodingLabel
+ - CDPCompliancePolicyUserFeedback
+ - WebpageActivityEndpoint
+ - OMEPortal
+ - CMImprovementActionChange
+ - FilteringUrlClick
+ - MipLabelAnalyticsAuditRecord
+ - FilteringEntityEvent
+ - FilteringRuleHits
+ - FilteringMailSubmission
+ - LabelExplorer
+ - MicrosoftManagedServicePlatform
+ - PowerPlatformServiceActivity
+ - ScorePlatformGenericAuditRecord
+ - FilteringTimeTravelDocMetadata
+ - Alert
+ - AlertStatus
+ - AlertIncident
+ - IncidentStatus
+ - Case
+ - CaseInvestigation
+ - RecordsManagement
+ - PrivacyRemediation
+ - DataShareOperation
+ - CdpDlpSensitive
+ - EHRConnector
+ - FilteringMailGradingResult
+ - PublicFolder
+ - PrivacyTenantAuditHistoryRecord
+ - AipScannerDiscoverEvent
+ - EduDataLakeDownloadOperation
+ - M365ComplianceConnector
+ - MicrosoftGraphDataConnectOperation
+ - MicrosoftPurview
+ - FilteringEmailContentFeatures
+ - PowerPagesSite
+ - PowerAppsResource
+ - PlannerPlan
+ - PlannerCopyPlan
+ - PlannerTask
+ - PlannerRoster
+ - PlannerPlanList
+ - PlannerTaskList
+ - PlannerTenantSettings
+ - ProjectForTheWebProject
+ - ProjectForTheWebTask
+ - ProjectForTheWebRoadmap
+ - ProjectForTheWebRoadmapItem
+ - ProjectForTheWebProjectSettings
+ - ProjectForTheWebRoadmapSettings
+ - QuarantineMetadata
+ - MicrosoftTodoAudit
+ - TimeTravelFilteringDocMetadata
+ - TeamsQuarantineMetadata
+ - SharePointAppPermissionOperation
+ - MicrosoftTeamsSensitivityLabelAction
+ - FilteringTeamsMetadata
+ - FilteringTeamsUrlInfo
+ - FilteringTeamsPostDeliveryAction
+ - MDCAssessments
+ - MDCRegulatoryComplianceStandards
+ - MDCRegulatoryComplianceControls
+ - MDCRegulatoryComplianceAssessments
+ - MDCSecurityConnectors
+ - MDADataSecuritySignal
+ - VivaGoals
+ - FilteringRuntimeInfo
+ - AttackSimAdmin
+ - MicrosoftGraphDataConnectConsent
+ - FilteringAtpDetonationInfo
+ - PrivacyPortal
+ - ManagedTenants
+ - UnifiedSimulationMatchedItem
+ - UnifiedSimulationSummary
+ - UpdateQuarantineMetadata
+ - MS365DSuppressionRule
+ - PurviewDataMapOperation
+ - FilteringUrlPostClickAction
+ - IrmUserDefinedDetectionSignal
+ - TeamsUpdates
+ - PlannerRosterSensitivityLabel
+ - MS365DIncident
+ - FilteringDelistingMetadata
+ - ComplianceDLPSharePointClassificationExtended
+ - MicrosoftDefenderForIdentityAudit
+ - SupervisoryReviewDayXInsight
+ - DefenderExpertsforXDRAdmin
+ - CDPEdgeBlockedMessage
+ - HostedRpa
+ - CdpContentExplorerAggregateRecord
+ - CDPHygieneAttachmentInfo
+ - CDPHygieneSummary
+ - CDPPostMailDeliveryAction
+ - CDPEmailFeatures
+ - CDPHygieneUrlInfo
+ - CDPUrlClick
+ - CDPPackageManagerHygieneEvent
+ - FilteringDocScan
+ - TimeTravelFilteringDocScan
+ - MAPGOnboard
+ - VfamCreatePolicy
+ - VfamUpdatePolicy
+ - VfamDeletePolicy
+ - M365DAAD
+ - CdpColdCrawlStatus
+ - PowerPlatformAdministratorActivity
+ - Windows365CustomerLockbox
+ - CdpResourceScopeChangeEvent
+ - ComplianceCCExchangeExecutionResult
+ - CdpOcrCostEstimatorRecord
+ - CopilotInteraction
+ - CdpOcrBillingRecord
+ - ComplianceDLPApplications
+ - UAMOperation
+ - VivaLearning
+ - VivaLearningAdmin
+ - PurviewPolicyOperation
+ - PurviewMetadataPolicyOperation
+ - PeopleAdminSettings
+ - CdpComplianceDLPExchangeClassification
+ - CdpComplianceDLPSharePointClassification
+ - FilteringBulkSenderInsightData
+ - FilteringBulkThresholdInsightData
+ - PrivacyOpenAccess
+ - OWAAuth
+ - ComplianceDLPApplicationsClassification
+ - SharePointESignature
+ - Dynamics365BusinessCentral
+ - MeshWorlds
+ - VivaPulseResponse
+ - VivaPulseOrganizer
+ - VivaPulseAdmin
+ - VivaPulseReport
+ - AIAppInteraction
+ - ComplianceDLMExchange
+ - ComplianceDLMSharePoint
+ - ProjectForTheWebAssignedToMeSettings
+ - CPSOperation
+ - ComplianceDLPExchangeDiscovery
+ - PurviewMCRecommendation
+ - ComplianceDLPEndpointDiscovery
+ - InsiderRiskScopedUserInsights
+ - MicrosoftTeamsRetentionLabelAction
+ - AadRiskDetection
+ - AuditSearch
+ - AuditRetentionPolicy
+ - AuditConfig
+ - Microsoft365BackupBackupPolicy
+ - Microsoft365BackupRestoreTask
+ - Microsoft365BackupRestoreItem
+ - Microsoft365BackupBackupItem
+ - URBACAssignment
+ - URBACRole
+ - URBACEnableState
+ - IRMSecurityAlert
+ - PurviewInsiderRiskCases
+ - PurviewInsiderRiskAlerts
+ - InsiderRiskScopedUsers
+ - CdpConsumptionResource
+ - CreateCopilotPlugin
+ - UpdateCopilotPlugin
+ - DeleteCopilotPlugin
+ - EnableCopilotPlugin
+ - DisableCopilotPlugin
+ - CreateCopilotWorkspace
+ - UpdateCopilotWorkspace
+ - DeleteCopilotWorkspace
+ - EnableCopilotWorkspace
+ - DisableCopilotWorkspace
+ - CreateCopilotPromptBook
+ - UpdateCopilotPromptBook
+ - DeleteCopilotPromptBook
+ - EnableCopilotPromptBook
+ - DisableCopilotPromptBook
+ - UpdateCopilotSettings
+ - P4AIAssessmentRecord
+ - P4AIAssessmentLocationResultRecord
+ - ConnectedAIAppInteraction
+ - PrivaPrivacyConsentOperation
+ - PrivaPrivacyAssessmentOperation
+ - DataCatalogAccessRequests
+ - ComplianceSettingsChange
+ - DataSecurityInvestigation
+ - TeamCopilotInteraction
+ - IRMActivityAuditTrail
+ - SharePointContentSecurityPolicy
+ - CloudUpdateProfileConfig
+ - CloudUpdateTenantConfig
+ - CloudUpdateDeviceConfig
+ - DefenderPreviewFeatures
+ - DeviceDiscoverySettingsExclusion
+ - DeviceDiscoverySettingsAuthenticatedScans
+ - CriticalAssetManagementClassification
+ - DeviceDiscoverySettings
+ - USXWorkspaceOnboarding
+ - VivaGlintAdvancedConfiguration
+ - VivaGlintPulseProgram
+ - VivaGlintPulseProgramRespondentRate
+ - VivaGlintQuestion
+ - VivaGlintRole
+ - VivaGlintRubicon
+ - VivaGlintSupportAccess
+ - VivaGlintSystem
+ - VivaGlintUser
+ - VivaGlintUserGroup
+ - VivaGlintFeedbackProgram
+ - FabricAudit
+ - TrainableClassifier
+ - WebContentFiltering
+ - NoisyAlertPolicy
+ - OnDemandSharePointClassification
+ - AIInteractionsExport
+ - Microsoft365CopilotScheduledPrompt
+ - PlacesDirectory
+ - MDAAudit
+ - OpticalCharacterRecognition
+ - M365SearchSections
+ - OfficeClientRestrictedModeAction
+ - CrossTenantAccessPolicy
+ - OutlookCopilotAutomation
+ - VivaEngageNetworkAssociation
+ - AppAdminActivity
+ - AppSettingsAdminActivity
+ - UniversalPrintPrintJob
+ - SentinelNotebookOnLake
+ - SentinelJob
+ - SentinelGraph
+ - SentinelKQLOnLake
+ - SentinelPackage
+ - VivaAmplifyOutlookSensitivityLabel
+ - CopilotActions
+ - AIInteractionsSubscription
+ - AIInteractionsChangeNotification
+ - FilteringMailMetadataExtended
+ - SentinelLakeOnboarding
+ - SentinelLakeDataOnboarding
+ - OfficeRestrictedModeAction
+ - CopilotForSecurityTrigger
+ - CopilotAgentManagement
+ - P4AIAssessmentFabricScannerRecord
+ - PlannerGoal
+ - PlannerGoalList
+ - ThreatIntelligenceObject
+ - ThreatIntelligenceExport
+ - SubmissionAgenticGradingResult
+ - AgentAdminActivity
+ - DeployFeatureActivity
+ - AgentSettingsAdminActivity
+ - OrganizationalDataInM365
+ - PlannerChatMessage
+ - PlannerChatMessageList
+ - SentinelAITool
+ - M365ODSPAssetMetadata
+ - AIExecuteTool
+ - AIInvokeAgent
+ - AIInferenceCall
+ - CdpClassifierHealthRecord
+ - SensitiveInfoRemediationAgentData
+ - ComplianceDLPEnforcement
+ - A365AIExecuteTool
+ - A365AIInvokeAgent
+ - A365AIInferenceCall
+ - VivaEngageSegment
+ - RTIOperationsAgent
+ - ContentStoreMetadata
+ - CCRAIPolicyViolation
+ - PlannerPlanSensitivityLabel
+ - MosAgentInfoRecord
+ - A365AIRunSummary
+ - UnifiedCatalogConceptAction
+ - DefenderCaseManagement
+ - CopilotForSecurityLogging
+ - VivaEngageEvents
+ - CallActivityEvent
+ - SonarDetonationContentMetadata
+ - UniversalPrintManagement
+ - YammerUserHiding
+ - Microsoft365BackupGranularBrowseTask
+ - PurviewPostureAgent
+ - MSDECustomCollection
+ - SCPUsageEvent
+ - SCPConfigurationEvent
+ - MDCConfigurationEvent
+ - MDCUsageEvent
+ - A365SpanOutputs
+ - PowerPlatformTenantIsolation
+ - CDPDLMAIInteractionInsights
+ - P4AIAssessmentCategoryRecord
+ - SentinelLakeEncryption
+ - AZFWNetworkRule
+ - AZFWDnsQuery
+ - AZFWApplicationRuleAggregation
+ - TeamsEvalDataHubDataAccess
+ - TeamsEvalDataHubPermissionChange
+ - TeamsEvalDataHubAdminOperation
+ - VivaGlintOrganizationalData
+ - AlertSubmission
+ - AlertSubmissionResultDetail
+ - ComplianceSitGradingSharePoint
+ - CompliancePolicyGradingSharePoint
+ - AzureAISearchAudit
+ - P4AIRiskScoreRecord
+ - DragonCopilotAdmin
+ - AISpanOutputs
+ - EopSubmissionFeedEntity
+ - SonarFileDetonationEntity
+ - SonarSubmissionEntity
+ - SonarUrlDetonationEntity
+ - SubmissionEntity
+ - SonarDetonationEntity
+ - MicrosoftTeamsUserConcern
+ - VivaGlintAgenticCampaign
+ - MSPVectorSearchContentMetadata
+ - FabricPolicy
+ - SecurityCopilotAgentIdentityManagement
+ - CopilotSessionSharing
+ - DragonCopilotAccess
+ - DragonCopilotClinicalData
+ - DragonCopilotSession
+ - MosAgentInfoRecordV2
+ - SecurityDevelopmentLifecycleAILog
+ - MDASH
+ - DefenderSecurityForAIConfiguration
+ - SparkCoreCustomLivePool
+ - unknownFutureValue
+ type: string
+ description: Specifies the type of audit log record.
+ microsoft.graph.security.auditLogQueryStatus:
+ title: auditLogQueryStatus
+ enum:
+ - notStarted
+ - running
+ - succeeded
+ - failed
+ - cancelled
+ - unknownFutureValue
+ type: string
+ description: Status of an audit log query.
+ microsoft.graph.security.auditData:
+ title: auditData
+ type: object
+ properties:
+ dynamicProperties:
+ $ref: '#/components/schemas/microsoft.graph.security.auditRecordTypeDictionary'
+ additionalProperties:
+ type: object
+ description: Abstract base type for audit event data.
+ microsoft.graph.security.auditLogUserType:
+ title: auditLogUserType
+ enum:
+ - Regular
+ - Reserved
+ - Admin
+ - DcAdmin
+ - System
+ - Application
+ - ServicePrincipal
+ - CustomPolicy
+ - SystemPolicy
+ - PartnerTechnician
+ - Guest
+ - unknownFutureValue
+ type: string
+ description: Type of user associated with an audit log record.
microsoft.graph.security.case:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -29553,6 +31177,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -29746,6 +31375,15 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -29788,6 +31426,72 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.onPremisesExtensionAttributes:
+ title: onPremisesExtensionAttributes
+ type: object
+ properties:
+ extensionAttribute1:
+ type: string
+ description: First customizable extension attribute.
+ nullable: true
+ extensionAttribute10:
+ type: string
+ description: Tenth customizable extension attribute.
+ nullable: true
+ extensionAttribute11:
+ type: string
+ description: Eleventh customizable extension attribute.
+ nullable: true
+ extensionAttribute12:
+ type: string
+ description: Twelfth customizable extension attribute.
+ nullable: true
+ extensionAttribute13:
+ type: string
+ description: Thirteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute14:
+ type: string
+ description: Fourteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute15:
+ type: string
+ description: Fifteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute2:
+ type: string
+ description: Second customizable extension attribute.
+ nullable: true
+ extensionAttribute3:
+ type: string
+ description: Third customizable extension attribute.
+ nullable: true
+ extensionAttribute4:
+ type: string
+ description: Fourth customizable extension attribute.
+ nullable: true
+ extensionAttribute5:
+ type: string
+ description: Fifth customizable extension attribute.
+ nullable: true
+ extensionAttribute6:
+ type: string
+ description: Sixth customizable extension attribute.
+ nullable: true
+ extensionAttribute7:
+ type: string
+ description: Seventh customizable extension attribute.
+ nullable: true
+ extensionAttribute8:
+ type: string
+ description: Eighth customizable extension attribute.
+ nullable: true
+ extensionAttribute9:
+ type: string
+ description: Ninth customizable extension attribute.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
@@ -30619,6 +32323,264 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.security.analyzedEmailAttachment:
+ title: analyzedEmailAttachment
+ type: object
+ properties:
+ detonationDetails:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationDetails'
+ fileExtension:
+ type: string
+ description: Extension of the file.
+ nullable: true
+ fileName:
+ type: string
+ description: The name of the attachment in the email.
+ nullable: true
+ fileSize:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: Size of the file.
+ format: int32
+ nullable: true
+ fileType:
+ type: string
+ description: The type of the attachment in the email.
+ nullable: true
+ malwareFamily:
+ type: string
+ description: The threat name associated with the threat type.
+ nullable: true
+ sha256:
+ type: string
+ description: The SHA256 file hash of the attachment.
+ nullable: true
+ tenantAllowBlockListDetailInfo:
+ type: string
+ description: Details of entries in tenant allow/block list configured by tenant.
+ nullable: true
+ threatType:
+ $ref: '#/components/schemas/microsoft.graph.security.threatType'
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailAuthenticationDetail:
+ title: analyzedEmailAuthenticationDetail
+ type: object
+ properties:
+ compositeAuthentication:
+ type: string
+ description: 'A value used by Microsoft 365 to combine email authentication such as SPF, DKIM, and DMARC, to determine whether the message is authentic.'
+ nullable: true
+ dkim:
+ type: string
+ description: DomainKeys identified mail (DKIM). Indicates whether it was pass/fail/soft fail.
+ nullable: true
+ dmarc:
+ type: string
+ description: Domain-based Message Authentication. Indicates whether it was pass/fail/soft fail.
+ nullable: true
+ senderPolicyFramework:
+ type: string
+ description: Sender Policy Framework (SPF). Indicates whether it was pass/fail/soft fail.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.antispamDirectionality:
+ title: antispamDirectionality
+ enum:
+ - unknown
+ - inbound
+ - outbound
+ - intraOrg
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.analyzedEmailDlpRuleInfo:
+ title: analyzedEmailDlpRuleInfo
+ type: object
+ properties:
+ name:
+ type: string
+ description: Name of the the data loss prevention rule.
+ nullable: true
+ ruleId:
+ type: string
+ description: Unique identifier of the data loss prevention rule.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailExchangeTransportRuleInfo:
+ title: analyzedEmailExchangeTransportRuleInfo
+ type: object
+ properties:
+ name:
+ type: string
+ description: Name of the Exchange transport rules (ETRs) that are part of the email.
+ nullable: true
+ ruleId:
+ type: string
+ description: The ETR rule ID.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailDeliveryDetail:
+ title: analyzedEmailDeliveryDetail
+ type: object
+ properties:
+ action:
+ $ref: '#/components/schemas/microsoft.graph.security.deliveryAction'
+ latestThreats:
+ type: string
+ description: Latest known threat on the email.
+ nullable: true
+ location:
+ $ref: '#/components/schemas/microsoft.graph.security.deliveryLocation'
+ originalThreats:
+ type: string
+ description: Threats identified at the time of delivery.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailRecipientDetail:
+ title: analyzedEmailRecipientDetail
+ type: object
+ properties:
+ ccRecipients:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: Recipient address in the cc field.
+ domainName:
+ type: string
+ description: Domain name of the recipient.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailSenderDetail:
+ title: analyzedEmailSenderDetail
+ type: object
+ properties:
+ displayName:
+ type: string
+ description: Display name of sender from address.
+ nullable: true
+ domainCreationDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: Date and time of creation of the sender domain.
+ format: date-time
+ nullable: true
+ domainName:
+ type: string
+ description: Registered name of the domain.
+ nullable: true
+ domainOwner:
+ type: string
+ description: Owner of the domain.
+ nullable: true
+ fromAddress:
+ type: string
+ description: 'The sender email address in the mail From header, also known as the envelope sender or the P1 sender.'
+ nullable: true
+ ipv4:
+ type: string
+ description: The IPv4 address of the last detected mail server that relayed the message.
+ nullable: true
+ location:
+ type: string
+ description: Location of the domain.
+ nullable: true
+ mailFromAddress:
+ type: string
+ description: 'The sender email address in the From header, which is visible to email recipients on their email clients. Also known as P2 sender.'
+ nullable: true
+ mailFromDomainName:
+ type: string
+ description: Domain name of sender mail from address.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.threatDetectionDetail:
+ title: threatDetectionDetail
+ type: object
+ properties:
+ confidenceLevel:
+ type: string
+ description: Indicates the confidence level in the threat detection.
+ nullable: true
+ priorityAccountProtection:
+ type: string
+ description: Indicates if the account has priority protection enabled.
+ nullable: true
+ threats:
+ type: string
+ description: Lists the detected threats.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.threatType:
+ title: threatType
+ enum:
+ - unknown
+ - spam
+ - malware
+ - phish
+ - none
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.timelineEvent:
+ title: timelineEvent
+ type: object
+ properties:
+ eventDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time when the event occurred.
+ format: date-time
+ nullable: true
+ eventDetails:
+ type: string
+ description: Additional details or context about the event.
+ nullable: true
+ eventResult:
+ type: string
+ description: 'The outcome or result of the event, such as delivery location or action taken.'
+ nullable: true
+ eventSource:
+ $ref: '#/components/schemas/microsoft.graph.security.eventSource'
+ eventThreats:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: Collection of threats identified or associated with this event.
+ eventType:
+ $ref: '#/components/schemas/microsoft.graph.security.timelineEventType'
+ additionalProperties:
+ type: object
+ microsoft.graph.security.analyzedEmailUrl:
+ title: analyzedEmailUrl
+ type: object
+ properties:
+ detectionMethod:
+ type: string
+ description: The method used to detect threats in the URL.
+ nullable: true
+ detonationDetails:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationDetails'
+ tenantAllowBlockListDetailInfo:
+ type: string
+ description: Details of entries in tenant allow/block list configured by tenant.
+ nullable: true
+ threatType:
+ $ref: '#/components/schemas/microsoft.graph.security.threatType'
+ url:
+ type: string
+ description: 'The URL that is found in the email. This is full URL string, including query parameters.'
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.dataSecurityAndGovernance:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -31366,72 +33328,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.onPremisesExtensionAttributes:
- title: onPremisesExtensionAttributes
- type: object
- properties:
- extensionAttribute1:
- type: string
- description: First customizable extension attribute.
- nullable: true
- extensionAttribute10:
- type: string
- description: Tenth customizable extension attribute.
- nullable: true
- extensionAttribute11:
- type: string
- description: Eleventh customizable extension attribute.
- nullable: true
- extensionAttribute12:
- type: string
- description: Twelfth customizable extension attribute.
- nullable: true
- extensionAttribute13:
- type: string
- description: Thirteenth customizable extension attribute.
- nullable: true
- extensionAttribute14:
- type: string
- description: Fourteenth customizable extension attribute.
- nullable: true
- extensionAttribute15:
- type: string
- description: Fifteenth customizable extension attribute.
- nullable: true
- extensionAttribute2:
- type: string
- description: Second customizable extension attribute.
- nullable: true
- extensionAttribute3:
- type: string
- description: Third customizable extension attribute.
- nullable: true
- extensionAttribute4:
- type: string
- description: Fourth customizable extension attribute.
- nullable: true
- extensionAttribute5:
- type: string
- description: Fifth customizable extension attribute.
- nullable: true
- extensionAttribute6:
- type: string
- description: Sixth customizable extension attribute.
- nullable: true
- extensionAttribute7:
- type: string
- description: Seventh customizable extension attribute.
- nullable: true
- extensionAttribute8:
- type: string
- description: Eighth customizable extension attribute.
- nullable: true
- extensionAttribute9:
- type: string
- description: Ninth customizable extension attribute.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.passwordProfile:
title: passwordProfile
type: object
@@ -32889,7 +34785,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -33372,7 +35267,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -33579,7 +35474,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -34252,6 +36147,32 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.security.auditLogQueryCollectionResponse:
+ title: Collection of auditLogQuery
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQuery'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.auditLogRecordCollectionResponse:
+ title: Collection of auditLogRecord
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecord'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.security.ediscoveryCaseCollectionResponse:
title: Collection of ediscoveryCase
type: object
@@ -34434,6 +36355,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.security.analyzedEmailCollectionResponse:
+ title: Collection of analyzedEmail
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmail'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.sensitivityLabelCollectionResponse:
title: Collection of sensitivityLabel
type: object
@@ -35301,6 +37235,12 @@ components:
- custom
- unknownFutureValue
type: string
+ microsoft.graph.security.auditRecordTypeDictionary:
+ title: auditRecordTypeDictionary
+ type: object
+ additionalProperties:
+ type: object
+ description: A dictionary of name-value pairs for dynamic audit event properties.
microsoft.graph.security.caseStatus:
title: caseStatus
enum:
@@ -35992,6 +37932,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -36842,6 +38787,107 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.security.detonationDetails:
+ title: detonationDetails
+ type: object
+ properties:
+ analysisDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The time of detonation.
+ format: date-time
+ nullable: true
+ compromiseIndicators:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.compromiseIndicator'
+ description: Represents indicators and its associated verdict that suggests whether an email is compromised.
+ detonationBehaviourDetails:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationBehaviourDetails'
+ detonationBehaviourDetailsV2:
+ type: string
+ description: 'Shows the exact events that took place during detonation, and problematic or benign observations that contain URLs, IPs, domains, and files that were found during detonation in a JSON format.'
+ nullable: true
+ detonationChain:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationChain'
+ detonationObservables:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationObservables'
+ detonationScreenshotUri:
+ type: string
+ description: 'Show any screenshots that were captured during detonation. No screenshots are captured if the URL opens into a link that directly downloads a file. However, you see the downloaded file in the detonation chain.'
+ nullable: true
+ detonationVerdict:
+ type: string
+ description: The verdict of the detonation.
+ nullable: true
+ detonationVerdictReason:
+ type: string
+ description: The reason for the verdict of the detonation.
+ nullable: true
+ entityMetadata:
+ type: string
+ description: Additional metadata about the entity in JSON format.
+ nullable: true
+ mitreTechniques:
+ type: string
+ description: 'The attack techniques, as aligned with the MITRE ATT&CK framework.'
+ nullable: true
+ staticAnalysis:
+ type: string
+ description: The results of static analysis performed on the file or URL.
+ nullable: true
+ submissionSource:
+ type: string
+ description: The source of the submission.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.deliveryAction:
+ title: deliveryAction
+ enum:
+ - unknown
+ - deliveredToJunk
+ - delivered
+ - blocked
+ - replaced
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.deliveryLocation:
+ title: deliveryLocation
+ enum:
+ - unknown
+ - inbox_folder
+ - junkFolder
+ - deletedFolder
+ - quarantine
+ - onprem_external
+ - failed
+ - dropped
+ - others
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.eventSource:
+ title: eventSource
+ enum:
+ - system
+ - admin
+ - user
+ - unknownFutureValue
+ type: string
+ microsoft.graph.security.timelineEventType:
+ title: timelineEventType
+ enum:
+ - originalDelivery
+ - systemTimeTravel
+ - dynamicDelivery
+ - userUrlClick
+ - reprocessed
+ - zap
+ - quarantineRelease
+ - air
+ - unknown
+ - unknownFutureValue
+ type: string
microsoft.graph.activityMetadata:
title: activityMetadata
type: object
@@ -37061,6 +39107,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -37547,7 +39594,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -37563,13 +39610,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -41362,6 +43409,101 @@ components:
$ref: '#/components/schemas/microsoft.graph.plannerUserIds'
additionalProperties:
type: object
+ microsoft.graph.security.compromiseIndicator:
+ title: compromiseIndicator
+ type: object
+ properties:
+ value:
+ type: string
+ description: Indicator.
+ nullable: true
+ verdict:
+ $ref: '#/components/schemas/microsoft.graph.security.verdictCategory'
+ additionalProperties:
+ type: object
+ microsoft.graph.security.detonationBehaviourDetails:
+ title: detonationBehaviourDetails
+ type: object
+ properties:
+ actionStatus:
+ type: string
+ description: 'The status of the action performed during detonation (e.g., ''Successful'', ''Failed'', ''Blocked'').'
+ nullable: true
+ behaviourCapability:
+ type: string
+ description: Categorizes the capability or type of behavior observed.
+ nullable: true
+ behaviourGroup:
+ type: string
+ description: Groups related behaviors together for classification purposes.
+ nullable: true
+ details:
+ type: string
+ description: More contextual information about the observed behavior or action.
+ nullable: true
+ eventDateTime:
+ pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
+ type: string
+ description: The date and time when the behavior or action was observed during detonation.
+ format: date-time
+ nullable: true
+ operation:
+ type: string
+ description: The specific operation or action that was performed.
+ nullable: true
+ processId:
+ type: string
+ description: The unique identifier of the process involved in the behavior.
+ nullable: true
+ processName:
+ type: string
+ description: The name of the process that performed or was involved in the behavior.
+ nullable: true
+ target:
+ type: string
+ description: The target of the operation.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.detonationChain:
+ title: detonationChain
+ type: object
+ properties:
+ childNodes:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.security.detonationChain'
+ description: A list of all child nodes in the chain.
+ value:
+ type: string
+ description: The value of the chain.
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.security.detonationObservables:
+ title: detonationObservables
+ type: object
+ properties:
+ contactedIps:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The list of all contacted IPs in the detonation.
+ contactedUrls:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The list of all URLs found in the detonation.
+ droppedfiles:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: The list of all dropped files in the detonation.
+ additionalProperties:
+ type: object
microsoft.graph.userActivityType:
title: userActivityType
enum:
@@ -44255,6 +46397,20 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.security.verdictCategory:
+ title: verdictCategory
+ enum:
+ - none
+ - malware
+ - phish
+ - siteUnavailable
+ - spam
+ - decryptionFailed
+ - unsupportedUriScheme
+ - unsupportedFileType
+ - undefined
+ - unknownFutureValue
+ type: string
microsoft.graph.classifcationErrorBase:
title: classifcationErrorBase
type: object
@@ -47849,6 +50005,18 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.trainingLanguageDetailCollectionResponse'
+ microsoft.graph.security.auditLogQueryCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogQueryCollectionResponse'
+ microsoft.graph.security.auditLogRecordCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.auditLogRecordCollectionResponse'
microsoft.graph.security.ediscoveryCaseCollectionResponse:
description: Retrieved collection
content:
@@ -47933,6 +50101,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.security.ediscoveryReviewTagCollectionResponse'
+ microsoft.graph.security.analyzedEmailCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.security.analyzedEmailCollectionResponse'
microsoft.graph.sensitivityLabelCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/v1.0/Sites.yml b/openApiDocs/v1.0/Sites.yml
index 6cbc9e1e43..acc029c0ce 100644
--- a/openApiDocs/v1.0/Sites.yml
+++ b/openApiDocs/v1.0/Sites.yml
@@ -10207,13 +10207,12 @@ paths:
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
- '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions':
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions':
get:
tags:
- groups.site
- summary: Get versions from groups
- description: The list of previous versions of the list item.
- operationId: group.site.list.item_ListVersion
+ summary: Get permissions from groups
+ operationId: group.site.list.item_ListPermission
parameters:
- name: group-id
in: path
@@ -10284,7 +10283,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -10294,8 +10293,8 @@ paths:
post:
tags:
- groups.site
- summary: Create new navigation property to versions for groups
- operationId: group.site.list.item_CreateVersion
+ summary: Create new navigation property to permissions for groups
+ operationId: group.site.list.item_CreatePermission
parameters:
- name: group-id
in: path
@@ -10334,7 +10333,7 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ $ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
@@ -10342,17 +10341,16 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}':
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/{permission-id}':
get:
tags:
- groups.site
- summary: Get versions from groups
- description: The list of previous versions of the list item.
- operationId: group.site.list.item_GetVersion
+ summary: Get permissions from groups
+ operationId: group.site.list.item_GetPermission
parameters:
- name: group-id
in: path
@@ -10386,14 +10384,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
+ - name: permission-id
in: path
- description: The unique identifier of listItemVersion
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: listItemVersion
+ x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
@@ -10420,15 +10418,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- groups.site
- summary: Update the navigation property versions in groups
- operationId: group.site.list.item_UpdateVersion
+ summary: Update the navigation property permissions in groups
+ operationId: group.site.list.item_UpdatePermission
parameters:
- name: group-id
in: path
@@ -10462,20 +10460,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
+ - name: permission-id
in: path
- description: The unique identifier of listItemVersion
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: listItemVersion
+ x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ $ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
@@ -10483,15 +10481,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- groups.site
- summary: Delete navigation property versions for groups
- operationId: group.site.list.item_DeleteVersion
+ summary: Delete navigation property permissions for groups
+ operationId: group.site.list.item_DeletePermission
parameters:
- name: group-id
in: path
@@ -10525,14 +10523,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
+ - name: permission-id
in: path
- description: The unique identifier of listItemVersion
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: listItemVersion
+ x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
@@ -10545,13 +10543,16 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}/fields':
- get:
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
+ post:
tags:
- groups.site
- summary: Get fields from groups
- description: A collection of the fields and values for this version of the list item.
- operationId: group.site.list.item.version_GetField
+ summary: Invoke action grant
+ description: Grant users access to a link represented by a permission.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
+ operationId: group.site.list.item.permission_grant
parameters:
- name: group-id
in: path
@@ -10585,49 +10586,63 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
+ - name: permission-id
in: path
- description: The unique identifier of listItemVersion
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: listItemVersion
- - name: $select
- in: query
- description: Select properties to be returned
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- - name: $expand
- in: query
- description: Expand related entities
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ roles:
+ type: array
+ items:
+ type: string
+ nullable: true
+ recipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.driveRecipient'
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ title: Collection of permission
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/$count':
+ get:
tags:
- groups.site
- summary: Update the navigation property fields in groups
- operationId: group.site.list.item.version_UpdateField
+ summary: Get the number of the resource
+ operationId: group.site.list.item.permission_GetCount
parameters:
- name: group-id
in: path
@@ -10661,36 +10676,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
- in: path
- description: The unique identifier of listItemVersion
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: listItemVersion
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
- required: true
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions':
+ get:
tags:
- groups.site
- summary: Delete navigation property fields for groups
- operationId: group.site.list.item.version_DeleteField
+ summary: Get versions from groups
+ description: The list of previous versions of the list item.
+ operationId: group.site.list.item_ListVersion
parameters:
- name: group-id
in: path
@@ -10724,36 +10723,513 @@ paths:
schema:
type: string
x-ms-docs-key-type: listItem
- - name: listItemVersion-id
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.listItemVersionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - groups.site
+ summary: Create new navigation property to versions for groups
+ operationId: group.site.list.item_CreateVersion
+ parameters:
+ - name: group-id
in: path
- description: The unique identifier of listItemVersion
+ description: The unique identifier of group
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: listItemVersion
- - name: If-Match
- in: header
- description: ETag
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
style: simple
schema:
type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ required: true
responses:
2XX:
- description: Success
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.listItemVersion'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
- post:
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}':
+ get:
tags:
- groups.site
- summary: Invoke action restoreVersion
- description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
- externalDocs:
- description: Find more info here
- url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
- operationId: group.site.list.item.version_restoreVersion
+ summary: Get versions from groups
+ description: The list of previous versions of the list item.
+ operationId: group.site.list.item_GetVersion
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - groups.site
+ summary: Update the navigation property versions in groups
+ operationId: group.site.list.item_UpdateVersion
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.listItemVersion'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - groups.site
+ summary: Delete navigation property versions for groups
+ operationId: group.site.list.item_DeleteVersion
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}/fields':
+ get:
+ tags:
+ - groups.site
+ summary: Get fields from groups
+ description: A collection of the fields and values for this version of the list item.
+ operationId: group.site.list.item.version_GetField
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - groups.site
+ summary: Update the navigation property fields in groups
+ operationId: group.site.list.item.version_UpdateField
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - groups.site
+ summary: Delete navigation property fields for groups
+ operationId: group.site.list.item.version_DeleteField
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: listItemVersion-id
+ in: path
+ description: The unique identifier of listItemVersion
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItemVersion
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions/{listItemVersion-id}/microsoft.graph.restoreVersion':
+ post:
+ tags:
+ - groups.site
+ summary: Invoke action restoreVersion
+ description: 'Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/listitemversion-restore?view=graph-rest-1.0
+ operationId: group.site.list.item.version_restoreVersion
parameters:
- name: group-id
in: path
@@ -11663,6 +12139,426 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/permissions':
+ get:
+ tags:
+ - groups.site
+ summary: Get permissions from groups
+ operationId: group.site.list_ListPermission
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - groups.site
+ summary: Create new navigation property to permissions for groups
+ operationId: group.site.list_CreatePermission
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/permissions/{permission-id}':
+ get:
+ tags:
+ - groups.site
+ summary: Get permissions from groups
+ operationId: group.site.list_GetPermission
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - groups.site
+ summary: Update the navigation property permissions in groups
+ operationId: group.site.list_UpdatePermission
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - groups.site
+ summary: Delete navigation property permissions for groups
+ operationId: group.site.list_DeletePermission
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/permissions/{permission-id}/microsoft.graph.grant':
+ post:
+ tags:
+ - groups.site
+ summary: Invoke action grant
+ description: Grant users access to a link represented by a permission.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
+ operationId: group.site.list.permission_grant
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ roles:
+ type: array
+ items:
+ type: string
+ nullable: true
+ recipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.driveRecipient'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ title: Collection of permission
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/groups/{group-id}/sites/{site-id}/lists/{list-id}/permissions/$count':
+ get:
+ tags:
+ - groups.site
+ summary: Get the number of the resource
+ operationId: group.site.list.permission_GetCount
+ parameters:
+ - name: group-id
+ in: path
+ description: The unique identifier of group
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: group
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
'/groups/{group-id}/sites/{site-id}/lists/{list-id}/subscriptions':
get:
tags:
@@ -74109,6 +75005,426 @@ paths:
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
+ '/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions':
+ get:
+ tags:
+ - sites.list
+ summary: Get permissions from sites
+ operationId: site.list.item_ListPermission
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - sites.list
+ summary: Create new navigation property to permissions for sites
+ operationId: site.list.item_CreatePermission
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/{permission-id}':
+ get:
+ tags:
+ - sites.list
+ summary: Get permissions from sites
+ operationId: site.list.item_GetPermission
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - sites.list
+ summary: Update the navigation property permissions in sites
+ operationId: site.list.item_UpdatePermission
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - sites.list
+ summary: Delete navigation property permissions for sites
+ operationId: site.list.item_DeletePermission
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/{permission-id}/microsoft.graph.grant':
+ post:
+ tags:
+ - sites.list
+ summary: Invoke action grant
+ description: Grant users access to a link represented by a permission.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
+ operationId: site.list.item.permission_grant
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ roles:
+ type: array
+ items:
+ type: string
+ nullable: true
+ recipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.driveRecipient'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ title: Collection of permission
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/sites/{site-id}/lists/{list-id}/items/{listItem-id}/permissions/$count':
+ get:
+ tags:
+ - sites.list
+ summary: Get the number of the resource
+ operationId: site.list.item.permission_GetCount
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: listItem-id
+ in: path
+ description: The unique identifier of listItem
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: listItem
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
'/sites/{site-id}/lists/{list-id}/items/{listItem-id}/versions':
get:
tags:
@@ -74957,18 +76273,322 @@ paths:
type: string
responses:
2XX:
- description: Entity result.
+ description: Entity result.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ default:
+ $ref: '#/components/responses/error'
+ patch:
+ tags:
+ - sites.list
+ summary: Update property mailboxSettings value.
+ operationId: site.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ requestBody:
+ description: New property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ default:
+ $ref: '#/components/responses/error'
+ '/sites/{site-id}/lists/{list-id}/lastModifiedByUser/serviceProvisioningErrors':
+ get:
+ tags:
+ - sites.list
+ summary: Get serviceProvisioningErrors property value
+ description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
+ operationId: site.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/sites/{site-id}/lists/{list-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
+ get:
+ tags:
+ - sites.list
+ summary: Get the number of the resource
+ operationId: site.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/sites/{site-id}/lists/{list-id}/operations':
+ get:
+ tags:
+ - sites.list
+ summary: Get operations from sites
+ description: The collection of long-running operations on the list.
+ operationId: site.list_ListOperation
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - $ref: '#/components/parameters/top'
+ - $ref: '#/components/parameters/skip'
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ - $ref: '#/components/parameters/count'
+ - name: $orderby
+ in: query
+ description: Order items by property values
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ $ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - sites.list
+ summary: Create new navigation property to operations for sites
+ operationId: site.list_CreateOperation
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/sites/{site-id}/lists/{list-id}/operations/{richLongRunningOperation-id}':
+ get:
+ tags:
+ - sites.list
+ summary: Get operations from sites
+ description: The collection of long-running operations on the list.
+ operationId: site.list_GetOperation
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: richLongRunningOperation-id
+ in: path
+ description: The unique identifier of richLongRunningOperation
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: richLongRunningOperation
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
+ schema:
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ responses:
+ 2XX:
+ description: Retrieved navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
patch:
tags:
- sites.list
- summary: Update property mailboxSettings value.
- operationId: site.list.lastModifiedGraphBPreUser_UpdateMailboxSetting
+ summary: Update the navigation property operations in sites
+ operationId: site.list_UpdateOperation
parameters:
- name: site-id
in: path
@@ -74986,12 +76606,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: list
+ - name: richLongRunningOperation-id
+ in: path
+ description: The unique identifier of richLongRunningOperation
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: richLongRunningOperation
requestBody:
- description: New property values
+ description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
required: true
responses:
2XX:
@@ -74999,16 +76627,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mailboxSettings'
+ $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
default:
$ref: '#/components/responses/error'
- '/sites/{site-id}/lists/{list-id}/lastModifiedByUser/serviceProvisioningErrors':
- get:
+ x-ms-docs-operation-type: operation
+ delete:
tags:
- sites.list
- summary: Get serviceProvisioningErrors property value
- description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports $filter (eq, not, for isResolved and serviceInstance).'
- operationId: site.list.lastModifiedGraphBPreUser_ListServiceProvisioningError
+ summary: Delete navigation property operations for sites
+ operationId: site.list_DeleteOperation
parameters:
- name: site-id
in: path
@@ -75026,55 +76653,32 @@ paths:
schema:
type: string
x-ms-docs-key-type: list
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- - $ref: '#/components/parameters/count'
- - name: $orderby
- in: query
- description: Order items by property values
- style: form
- explode: false
- schema:
- uniqueItems: true
- type: array
- items:
- type: string
- - name: $select
- in: query
- description: Select properties to be returned
- style: form
- explode: false
+ - name: richLongRunningOperation-id
+ in: path
+ description: The unique identifier of richLongRunningOperation
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
- - name: $expand
- in: query
- description: Expand related entities
- style: form
- explode: false
+ type: string
+ x-ms-docs-key-type: richLongRunningOperation
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.serviceProvisioningErrorCollectionResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- '/sites/{site-id}/lists/{list-id}/lastModifiedByUser/serviceProvisioningErrors/$count':
+ x-ms-docs-operation-type: operation
+ '/sites/{site-id}/lists/{list-id}/operations/$count':
get:
tags:
- sites.list
summary: Get the number of the resource
- operationId: site.list.lastModifiedGraphBPreUser.ServiceProvisioningError_GetCount
+ operationId: site.list.operation_GetCount
parameters:
- name: site-id
in: path
@@ -75099,13 +76703,12 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/sites/{site-id}/lists/{list-id}/operations':
+ '/sites/{site-id}/lists/{list-id}/permissions':
get:
tags:
- sites.list
- summary: Get operations from sites
- description: The collection of long-running operations on the list.
- operationId: site.list_ListOperation
+ summary: Get permissions from sites
+ operationId: site.list_ListPermission
parameters:
- name: site-id
in: path
@@ -75160,7 +76763,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.richLongRunningOperationCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.permissionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -75170,8 +76773,8 @@ paths:
post:
tags:
- sites.list
- summary: Create new navigation property to operations for sites
- operationId: site.list_CreateOperation
+ summary: Create new navigation property to permissions for sites
+ operationId: site.list_CreatePermission
parameters:
- name: site-id
in: path
@@ -75194,7 +76797,7 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ $ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
@@ -75202,17 +76805,16 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/sites/{site-id}/lists/{list-id}/operations/{richLongRunningOperation-id}':
+ '/sites/{site-id}/lists/{list-id}/permissions/{permission-id}':
get:
tags:
- sites.list
- summary: Get operations from sites
- description: The collection of long-running operations on the list.
- operationId: site.list_GetOperation
+ summary: Get permissions from sites
+ operationId: site.list_GetPermission
parameters:
- name: site-id
in: path
@@ -75230,14 +76832,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: list
- - name: richLongRunningOperation-id
+ - name: permission-id
in: path
- description: The unique identifier of richLongRunningOperation
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: richLongRunningOperation
+ x-ms-docs-key-type: permission
- name: $select
in: query
description: Select properties to be returned
@@ -75264,15 +76866,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- sites.list
- summary: Update the navigation property operations in sites
- operationId: site.list_UpdateOperation
+ summary: Update the navigation property permissions in sites
+ operationId: site.list_UpdatePermission
parameters:
- name: site-id
in: path
@@ -75290,20 +76892,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: list
- - name: richLongRunningOperation-id
+ - name: permission-id
in: path
- description: The unique identifier of richLongRunningOperation
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: richLongRunningOperation
+ x-ms-docs-key-type: permission
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ $ref: '#/components/schemas/microsoft.graph.permission'
required: true
responses:
2XX:
@@ -75311,15 +76913,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
+ $ref: '#/components/schemas/microsoft.graph.permission'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- sites.list
- summary: Delete navigation property operations for sites
- operationId: site.list_DeleteOperation
+ summary: Delete navigation property permissions for sites
+ operationId: site.list_DeletePermission
parameters:
- name: site-id
in: path
@@ -75337,14 +76939,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: list
- - name: richLongRunningOperation-id
+ - name: permission-id
in: path
- description: The unique identifier of richLongRunningOperation
+ description: The unique identifier of permission
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: richLongRunningOperation
+ x-ms-docs-key-type: permission
- name: If-Match
in: header
description: ETag
@@ -75357,12 +76959,90 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/sites/{site-id}/lists/{list-id}/operations/$count':
+ '/sites/{site-id}/lists/{list-id}/permissions/{permission-id}/microsoft.graph.grant':
+ post:
+ tags:
+ - sites.list
+ summary: Invoke action grant
+ description: Grant users access to a link represented by a permission.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/permission-grant?view=graph-rest-1.0
+ operationId: site.list.permission_grant
+ parameters:
+ - name: site-id
+ in: path
+ description: The unique identifier of site
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: site
+ - name: list-id
+ in: path
+ description: The unique identifier of list
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: list
+ - name: permission-id
+ in: path
+ description: The unique identifier of permission
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: permission
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ roles:
+ type: array
+ items:
+ type: string
+ nullable: true
+ recipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.driveRecipient'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ title: Collection of permission
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/sites/{site-id}/lists/{list-id}/permissions/$count':
get:
tags:
- sites.list
summary: Get the number of the resource
- operationId: site.list.operation_GetCount
+ operationId: site.list.permission_GetCount
parameters:
- name: site-id
in: path
@@ -116076,7 +117756,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -116103,7 +117783,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -116250,7 +117930,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -116272,7 +117952,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -116305,7 +117985,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -116403,7 +118083,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -116660,7 +118340,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.mailboxSettings:
title: mailboxSettings
type: object
@@ -116827,6 +118506,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -116859,6 +118543,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -120990,7 +122679,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -122077,6 +123765,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.permissionCollectionResponse:
+ title: Collection of permission
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.listItemVersionCollectionResponse:
title: Collection of listItemVersion
type: object
@@ -122129,19 +123830,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.permissionCollectionResponse:
- title: Collection of permission
- type: object
- properties:
- value:
- type: array
- items:
- $ref: '#/components/schemas/microsoft.graph.permission'
- '@odata.nextLink':
- type: string
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.termStore.storeCollectionResponse:
title: Collection of store
type: object
@@ -122763,6 +124451,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -123601,7 +125290,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -123617,13 +125306,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -124052,7 +125741,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -124142,6 +125831,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -124150,7 +125841,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -124213,6 +125904,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -124247,6 +125942,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -124324,11 +126021,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -124475,7 +126186,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -124561,7 +126271,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -127672,6 +129382,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -133519,6 +135238,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.documentSetVersionCollectionResponse'
+ microsoft.graph.permissionCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.permissionCollectionResponse'
microsoft.graph.listItemVersionCollectionResponse:
description: Retrieved collection
content:
@@ -133543,12 +135268,6 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.baseSitePageCollectionResponse'
- microsoft.graph.permissionCollectionResponse:
- description: Retrieved collection
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.permissionCollectionResponse'
microsoft.graph.termStore.storeCollectionResponse:
description: Retrieved collection
content:
diff --git a/openApiDocs/v1.0/Teams.yml b/openApiDocs/v1.0/Teams.yml
index 7065afd5d8..68ce635f85 100644
--- a/openApiDocs/v1.0/Teams.yml
+++ b/openApiDocs/v1.0/Teams.yml
@@ -26424,7 +26424,7 @@ paths:
tags:
- teams.channel
summary: List allowedMembers
- description: "Get the list of conversationMembers who can access a shared channel. This method does not return the following conversationMembers from the team:\r\n- Users with Guest role\r\n- Users who are externally authenticated in the tenant"
+ description: "Get the list of conversationMembers who can access a shared channel. This method doesn't return the following conversationMembers from the team:\r\n- Users with Guest role\r\n- Users who are externally authenticated in the tenant"
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/sharedwithchannelteaminfo-list-allowedmembers?view=graph-rest-1.0
@@ -34606,7 +34606,7 @@ paths:
tags:
- teams.schedule
summary: Delete schedulingGroup
- description: "Mark a schedulingGroup as inactive by setting its isActive property.\r\nThis method does not remove the schedulingGroup from the schedule. Existing shift instances assigned to the scheduling group remain part of the group."
+ description: "Mark a schedulingGroup as inactive by setting its isActive property.\r\nThis method doesn't remove the schedulingGroup from the schedule. Existing shift instances assigned to the scheduling group remain part of the group."
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/schedulinggroup-delete?view=graph-rest-1.0
@@ -69361,7 +69361,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -69377,13 +69377,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -69695,7 +69695,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -69917,6 +69917,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -69925,7 +69927,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -69988,6 +69990,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -70022,6 +70028,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -70099,11 +70107,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -70250,7 +70272,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamVisibilityType:
title: teamVisibilityType
enum:
@@ -70377,7 +70398,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -72050,6 +72071,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -72288,6 +72314,15 @@ components:
$ref: '#/components/schemas/microsoft.graph.team'
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -72330,6 +72365,72 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.onPremisesExtensionAttributes:
+ title: onPremisesExtensionAttributes
+ type: object
+ properties:
+ extensionAttribute1:
+ type: string
+ description: First customizable extension attribute.
+ nullable: true
+ extensionAttribute10:
+ type: string
+ description: Tenth customizable extension attribute.
+ nullable: true
+ extensionAttribute11:
+ type: string
+ description: Eleventh customizable extension attribute.
+ nullable: true
+ extensionAttribute12:
+ type: string
+ description: Twelfth customizable extension attribute.
+ nullable: true
+ extensionAttribute13:
+ type: string
+ description: Thirteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute14:
+ type: string
+ description: Fourteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute15:
+ type: string
+ description: Fifteenth customizable extension attribute.
+ nullable: true
+ extensionAttribute2:
+ type: string
+ description: Second customizable extension attribute.
+ nullable: true
+ extensionAttribute3:
+ type: string
+ description: Third customizable extension attribute.
+ nullable: true
+ extensionAttribute4:
+ type: string
+ description: Fourth customizable extension attribute.
+ nullable: true
+ extensionAttribute5:
+ type: string
+ description: Fifth customizable extension attribute.
+ nullable: true
+ extensionAttribute6:
+ type: string
+ description: Sixth customizable extension attribute.
+ nullable: true
+ extensionAttribute7:
+ type: string
+ description: Seventh customizable extension attribute.
+ nullable: true
+ extensionAttribute8:
+ type: string
+ description: Eighth customizable extension attribute.
+ nullable: true
+ extensionAttribute9:
+ type: string
+ description: Ninth customizable extension attribute.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.onPremisesProvisioningError:
title: onPremisesProvisioningError
type: object
@@ -73974,7 +74075,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -74001,7 +74102,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -74148,7 +74249,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -74170,7 +74271,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -74203,7 +74304,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -74301,7 +74402,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -74558,7 +74659,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.album:
title: album
type: object
@@ -75442,6 +75542,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -76278,72 +76383,6 @@ components:
$ref: '#/components/schemas/microsoft.graph.workingHours'
additionalProperties:
type: object
- microsoft.graph.onPremisesExtensionAttributes:
- title: onPremisesExtensionAttributes
- type: object
- properties:
- extensionAttribute1:
- type: string
- description: First customizable extension attribute.
- nullable: true
- extensionAttribute10:
- type: string
- description: Tenth customizable extension attribute.
- nullable: true
- extensionAttribute11:
- type: string
- description: Eleventh customizable extension attribute.
- nullable: true
- extensionAttribute12:
- type: string
- description: Twelfth customizable extension attribute.
- nullable: true
- extensionAttribute13:
- type: string
- description: Thirteenth customizable extension attribute.
- nullable: true
- extensionAttribute14:
- type: string
- description: Fourteenth customizable extension attribute.
- nullable: true
- extensionAttribute15:
- type: string
- description: Fifteenth customizable extension attribute.
- nullable: true
- extensionAttribute2:
- type: string
- description: Second customizable extension attribute.
- nullable: true
- extensionAttribute3:
- type: string
- description: Third customizable extension attribute.
- nullable: true
- extensionAttribute4:
- type: string
- description: Fourth customizable extension attribute.
- nullable: true
- extensionAttribute5:
- type: string
- description: Fifth customizable extension attribute.
- nullable: true
- extensionAttribute6:
- type: string
- description: Sixth customizable extension attribute.
- nullable: true
- extensionAttribute7:
- type: string
- description: Seventh customizable extension attribute.
- nullable: true
- extensionAttribute8:
- type: string
- description: Eighth customizable extension attribute.
- nullable: true
- extensionAttribute9:
- type: string
- description: Ninth customizable extension attribute.
- nullable: true
- additionalProperties:
- type: object
microsoft.graph.passwordProfile:
title: passwordProfile
type: object
@@ -77708,7 +77747,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.outlookUser:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -78057,6 +78095,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.workbookOperationError:
title: workbookOperationError
type: object
diff --git a/openApiDocs/v1.0/Users.Actions.yml b/openApiDocs/v1.0/Users.Actions.yml
index 6522807cea..161a667ae1 100644
--- a/openApiDocs/v1.0/Users.Actions.yml
+++ b/openApiDocs/v1.0/Users.Actions.yml
@@ -1003,7 +1003,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -1030,7 +1030,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -1177,7 +1177,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -1199,7 +1199,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -1232,7 +1232,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -1330,7 +1330,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -1587,7 +1587,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.ODataErrors.ODataError:
required:
- error
@@ -4066,7 +4065,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -4671,6 +4669,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -5369,7 +5368,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -5385,13 +5384,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -5855,6 +5854,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -6466,7 +6470,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -6556,6 +6560,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -6564,7 +6570,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -6627,6 +6633,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -6661,6 +6671,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -6738,11 +6750,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -6889,7 +6915,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -6975,7 +7000,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -10335,6 +10360,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -11296,6 +11326,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
diff --git a/openApiDocs/v1.0/Users.Functions.yml b/openApiDocs/v1.0/Users.Functions.yml
index b4b78780bd..9360646a6a 100644
--- a/openApiDocs/v1.0/Users.Functions.yml
+++ b/openApiDocs/v1.0/Users.Functions.yml
@@ -322,7 +322,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -349,7 +349,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -496,7 +496,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -518,7 +518,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -551,7 +551,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -649,7 +649,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -906,7 +906,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.directoryObject:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -3269,7 +3268,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.onPremisesSyncBehavior:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -3656,7 +3654,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone'
eventId:
type: string
- description: The unique ID of the event. Read only.
+ description: The unique ID of the event. Read-only.
nullable: true
eventLocation:
$ref: '#/components/schemas/microsoft.graph.location'
@@ -3799,6 +3797,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -4668,7 +4667,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -4684,13 +4683,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -5154,6 +5153,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -5765,7 +5769,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -5855,6 +5859,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -5863,7 +5869,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -5926,6 +5932,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -5960,6 +5970,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -6037,11 +6049,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -6188,7 +6214,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.teamsAsyncOperation:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -6274,7 +6299,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -9656,6 +9681,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
@@ -10617,6 +10647,15 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
diff --git a/openApiDocs/v1.0/Users.yml b/openApiDocs/v1.0/Users.yml
index f7e21228d1..6eab7f412e 100644
--- a/openApiDocs/v1.0/Users.yml
+++ b/openApiDocs/v1.0/Users.yml
@@ -149,7 +149,7 @@ paths:
tags:
- users.user
summary: Update user
- description: Update the properties of a user object.
+ description: 'Update the properties of a user object. To use this API to update an agentUser, specify an @odata.type property with a value of #microsoft.graph.agentUser in the request body.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/user-update?view=graph-rest-1.0
@@ -12524,7 +12524,7 @@ paths:
tags:
- users.user
summary: Update user
- description: Update the properties of a user object.
+ description: 'Update the properties of a user object. To use this API to update an agentUser, specify an @odata.type property with a value of #microsoft.graph.agentUser in the request body.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/user-update?view=graph-rest-1.0
@@ -12623,7 +12623,7 @@ components:
nullable: true
accountEnabled:
type: boolean
- description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in).'
+ description: 'true if the account is enabled; otherwise, false. This property is required when a user is created. Requires $select to retrieve. Supports $filter (eq, ne, not, and in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
ageGroup:
type: string
@@ -12650,7 +12650,7 @@ components:
type: array
items:
type: string
- description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith).'
+ description: 'The telephone numbers for the user. NOTE: Although it''s a string collection, only one number can be set for this property. Read-only for users synced from the on-premises directory. Returned by default. Supports $filter (eq, not, ge, le, startsWith). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
city:
type: string
description: 'The city where the user is located. Maximum length is 128 characters. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).'
@@ -12797,7 +12797,7 @@ components:
nullable: true
mobilePhone:
type: string
- description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.'
+ description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Maximum length is 64 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
mySite:
type: string
@@ -12819,7 +12819,7 @@ components:
$ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesImmutableId:
type: string
- description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in).'
+ description: 'This property is used to associate an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. NOTE: The $ and _ characters can''t be used when specifying this property. Requires $select to retrieve. Supports $filter (eq, ne, not, ge, le, in). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
@@ -12852,7 +12852,7 @@ components:
type: array
items:
type: string
- description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).'
+ description: 'A list of other email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters. Requires $select to retrieve. Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0). This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
passwordPolicies:
type: string
description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two might be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. Requires $select to retrieve. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).'
@@ -12950,7 +12950,7 @@ components:
nullable: true
userPrincipalName:
type: string
- description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.'
+ description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this value should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby. This property is subject to sensitive action restrictions; only specific privileged administrator roles can update it.'
nullable: true
userType:
type: string
@@ -13207,7 +13207,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra user account.
microsoft.graph.directoryObject:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -13796,7 +13795,7 @@ components:
nullable: true
roleTemplateId:
type: string
- description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read only. Supports $filter (eq), $select.'
+ description: 'The id of the directoryRoleTemplate that this role is based on. The property must be specified when activating a directory role in a tenant with a POST operation. After the directory role has been activated, the property is read-only. Supports $filter (eq), $select.'
nullable: true
members:
type: array
@@ -13818,6 +13817,8 @@ components:
- title: group
type: object
properties:
+ accessType:
+ $ref: '#/components/schemas/microsoft.graph.groupAccessType'
allowExternalSenders:
type: boolean
description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
@@ -13826,7 +13827,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.assignedLabel'
- description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.'
+ description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group or a cloud security group. Requires a Microsoft Entra ID P1 license. Requires $select to retrieve. This property can be specified during group creation or update. However, for cloud security groups, it''s immutable once set. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role. See Key differences from Microsoft 365 group labeling to learn more about managing this property for Microsoft 365 vs. cloud security groups.'
assignedLicenses:
type: array
items:
@@ -13889,6 +13890,10 @@ components:
type: boolean
description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group can''t be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).'
nullable: true
+ isFavorite:
+ type: boolean
+ description: 'Indicates whether the user marked the group as favorite. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ nullable: true
isManagementRestricted:
type: boolean
description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit. Requires $select to retrieve.'
@@ -13923,6 +13928,8 @@ components:
type: string
description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.'
nullable: true
+ onPremisesExtensionAttributes:
+ $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes'
onPremisesLastSyncDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
@@ -14000,11 +14007,25 @@ components:
type: string
description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only.
nullable: true
+ unseenConversationsCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of conversations that have had one or more new posts delivered since the signed-in user''s last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
unseenCount:
maximum: 2147483647
minimum: -2147483648
type: number
- description: 'Count of conversations that received new posts since the signed-in user last visited the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
+ format: int32
+ nullable: true
+ unseenMessagesCount:
+ maximum: 2147483647
+ minimum: -2147483648
+ type: number
+ description: 'Count of new posts that have been delivered to the group''s conversations since the signed-in user''s last visit to the group. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).'
format: int32
nullable: true
visibility:
@@ -14151,7 +14172,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft Entra group.
microsoft.graph.oAuth2PermissionGrant:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -17450,7 +17470,6 @@ components:
x-ms-navigationProperty: true
additionalProperties:
type: object
- description: Represents a Microsoft online meeting.
microsoft.graph.person:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -17999,6 +18018,7 @@ components:
subject:
type: string
description: 'Required. The identifier of the external software workload within the external identity provider. Like the audience value, it has no fixed format; each identity provider uses their own - sometimes a GUID, sometimes a colon delimited identifier, sometimes arbitrary strings. The value here must match the sub claim within the token presented to Microsoft Entra ID. The combination of issuer and subject must be unique within the app. It has a limit of 600 characters. Supports $filter (eq).'
+ nullable: true
additionalProperties:
type: object
microsoft.graph.homeRealmDiscoveryPolicy:
@@ -18338,6 +18358,15 @@ components:
$ref: '#/components/schemas/microsoft.graph.timeZoneBase'
additionalProperties:
type: object
+ microsoft.graph.groupAccessType:
+ title: groupAccessType
+ enum:
+ - none
+ - private
+ - secret
+ - public
+ - unknownFutureValue
+ type: string
microsoft.graph.assignedLabel:
title: assignedLabel
type: object
@@ -19429,6 +19458,7 @@ components:
type: object
additionalProperties:
type: object
+ description: Standard way to represent a Json blob on Graph.
microsoft.graph.status:
title: status
enum:
@@ -20256,7 +20286,7 @@ components:
deletedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp at which the chat message was deleted, or null if not deleted.'
+ description: 'Read-only. Timestamp at which the chat message was deleted, or null if not deleted.'
format: date-time
nullable: true
etag:
@@ -20272,13 +20302,13 @@ components:
lastEditedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
+ description: Read-only. Timestamp when edits to the chat message were made. Triggers an 'Edited' flag in the Teams UI. If no edits are made the value is null.
format: date-time
nullable: true
lastModifiedDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: 'Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
+ description: 'Read-only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed.'
format: date-time
nullable: true
locale:
@@ -20742,6 +20772,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.richLongRunningOperation'
description: The collection of long-running operations on the list.
x-ms-navigationProperty: true
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
subscriptions:
type: array
items:
@@ -21327,7 +21362,7 @@ components:
createdDateTime:
pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$'
type: string
- description: Read only. Timestamp at which the channel was created.
+ description: Read-only. Timestamp at which the channel was created.
format: date-time
nullable: true
description:
@@ -21496,7 +21531,7 @@ components:
nullable: true
timeZone:
type: string
- description: Indicates the time zone of the schedule team using tz database format. Required.
+ description: 'The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required.'
nullable: true
workforceIntegrationIds:
type: array
@@ -24935,6 +24970,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.driveItem'
fields:
$ref: '#/components/schemas/microsoft.graph.fieldValueSet'
+ permissions:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.permission'
+ x-ms-navigationProperty: true
versions:
type: array
items:
diff --git a/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md b/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md
index d05037861a..e69de29bb2 100644
--- a/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md
+++ b/src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md
@@ -1,11 +0,0 @@
-### Example
-
-```powershell
-
-Import-Module Microsoft.Graph.Beta.Applications
-
-Get-MgBetaServicePrincipalSynchronizationTemplate -ServicePrincipalId $servicePrincipalId
-
-```
-This example shows how to use the Get-MgBetaServicePrincipalSynchronizationTemplate Cmdlet.
-
diff --git a/src/Authentication/Authentication.Core/Interfaces/IAuthContext.cs b/src/Authentication/Authentication.Core/Interfaces/IAuthContext.cs
index 9956c8dcf2..16dd6fd202 100644
--- a/src/Authentication/Authentication.Core/Interfaces/IAuthContext.cs
+++ b/src/Authentication/Authentication.Core/Interfaces/IAuthContext.cs
@@ -45,6 +45,7 @@ public interface IAuthContext
string Environment { get; set; }
string AppName { get; set; }
string Account { get; set; }
+ string LoginHint { get; set; }
string HomeAccountId { get; set; }
string CertificateThumbprint { get; set; }
string CertificateSubjectName { get; set; }
diff --git a/src/Authentication/Authentication.Core/Microsoft.Graph.Authentication.Core.csproj b/src/Authentication/Authentication.Core/Microsoft.Graph.Authentication.Core.csproj
index 9760b5f239..2bd53b18f1 100644
--- a/src/Authentication/Authentication.Core/Microsoft.Graph.Authentication.Core.csproj
+++ b/src/Authentication/Authentication.Core/Microsoft.Graph.Authentication.Core.csproj
@@ -4,7 +4,7 @@
9.0
netstandard2.0;net6.0;net472
Microsoft.Graph.PowerShell.Authentication.Core
- 2.38.0
+ 2.38.1
true
diff --git a/src/Authentication/Authentication.Core/Utilities/AuthenticationHelpers.cs b/src/Authentication/Authentication.Core/Utilities/AuthenticationHelpers.cs
index e190172495..6041deb351 100644
--- a/src/Authentication/Authentication.Core/Utilities/AuthenticationHelpers.cs
+++ b/src/Authentication/Authentication.Core/Utilities/AuthenticationHelpers.cs
@@ -15,7 +15,9 @@
using System.Globalization;
using System.IO;
using System.Linq;
+using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
+using System.Text;
using System.Threading;
using System.Threading.Tasks;
@@ -120,10 +122,19 @@ private static async Task GetInteractiveBrowserCre
interactiveOptions.TenantId = authContext.TenantId ?? "common";
interactiveOptions.AuthorityHost = new Uri(GetAuthorityUrl(authContext));
interactiveOptions.TokenCachePersistenceOptions = GetTokenCachePersistenceOptions(authContext);
+ var loginHint = authContext.LoginHint;
+ if (!string.IsNullOrWhiteSpace(loginHint))
+ {
+ interactiveOptions.LoginHint = loginHint;
+ }
- if (!File.Exists(Constants.AuthRecordPath))
+ // Resolve the persisted authentication record for this account. When a login hint is
+ // supplied a per-account record is used so we never silently reuse a different user's
+ // record and so repeat sign-ins for the same account are picker-free.
+ var authRecord = await ResolveInteractiveAuthRecordAsync(loginHint).ConfigureAwait(false);
+
+ if (authRecord is null)
{
- AuthenticationRecord authRecord;
var interactiveBrowserCredential = new InteractiveBrowserCredential(interactiveOptions);
if (ShouldUseWam(authContext))
{
@@ -140,17 +151,99 @@ private static async Task GetInteractiveBrowserCre
return interactiveBrowserCredential.AuthenticateAsync(new TokenRequestContext(authContext.Scopes), cancellationToken);
});
}
- await WriteAuthRecordAsync(authRecord).ConfigureAwait(false);
+ await WriteAuthRecordAsync(authRecord, loginHint).ConfigureAwait(false);
authContext.HomeAccountId = TryGetHomeAccountId(authRecord);
return interactiveBrowserCredential;
}
- var interactiveAuthRecord = await ReadAuthRecordAsync().ConfigureAwait(false);
- interactiveOptions.AuthenticationRecord = interactiveAuthRecord;
- authContext.HomeAccountId = TryGetHomeAccountId(interactiveAuthRecord);
+ interactiveOptions.AuthenticationRecord = authRecord;
+ authContext.HomeAccountId = TryGetHomeAccountId(authRecord);
return new InteractiveBrowserCredential(interactiveOptions);
}
+ ///
+ /// Resolves the persisted to use for an interactive sign-in.
+ /// Without a login hint the shared, legacy record is used. With a login hint the per-account
+ /// record is preferred; if it is absent, an existing shared record is migrated only when it
+ /// belongs to the hinted account. A record whose username does not match the supplied hint is
+ /// never returned, so a different user's record is never silently reused.
+ ///
+ internal static async Task ResolveInteractiveAuthRecordAsync(string loginHint)
+ {
+ if (string.IsNullOrWhiteSpace(loginHint))
+ {
+ try
+ {
+ return await ReadAuthRecordAsync().ConfigureAwait(false);
+ }
+ catch
+ {
+ return null;
+ }
+ }
+
+ AuthenticationRecord keyedRecord = null;
+ try
+ {
+ keyedRecord = await ReadAuthRecordAsync(loginHint).ConfigureAwait(false);
+ }
+ catch
+ {
+ keyedRecord = null;
+ }
+
+ if (keyedRecord != null)
+ return MatchesLoginHint(keyedRecord, loginHint) ? keyedRecord : null;
+
+ // Migration: a pre-existing shared record for this same account is promoted to a
+ // per-account record so existing users are not forced through the account picker again.
+ AuthenticationRecord legacyRecord = null;
+ try
+ {
+ legacyRecord = await ReadAuthRecordAsync().ConfigureAwait(false);
+ }
+ catch
+ {
+ legacyRecord = null;
+ }
+
+ if (legacyRecord != null && MatchesLoginHint(legacyRecord, loginHint))
+ {
+ await WriteAuthRecordAsync(legacyRecord, loginHint).ConfigureAwait(false);
+ return legacyRecord;
+ }
+
+ return null;
+ }
+
+ ///
+ /// Determines whether the username on an matches the supplied
+ /// login hint (case-insensitive). Reading the username must never throw, so failures yield a
+ /// non-match, which forces a fresh interactive sign-in rather than reusing an unverified record.
+ ///
+ internal static bool MatchesLoginHint(AuthenticationRecord authRecord, string loginHint)
+ {
+ var username = TryGetUsername(authRecord);
+ return !string.IsNullOrWhiteSpace(username)
+ && string.Equals(username.Trim(), loginHint.Trim(), StringComparison.OrdinalIgnoreCase);
+ }
+
+ ///
+ /// Safely reads the username from an ; any error yields
+ /// null so account matching can never fail sign-in.
+ ///
+ private static string TryGetUsername(AuthenticationRecord authRecord)
+ {
+ try
+ {
+ return authRecord?.Username;
+ }
+ catch
+ {
+ return null;
+ }
+ }
+
private static async Task GetDeviceCodeCredentialAsync(IAuthContext authContext, CancellationToken cancellationToken = default)
{
if (authContext is null)
@@ -443,13 +536,17 @@ public static async Task LogoutAsync(bool signOutFromBroker = fals
var authContext = GraphSession.Instance.AuthContext;
GraphSession.Instance.InMemoryTokenCache?.ClearCache();
+ // The login hint (when supplied at sign-in) keys the per-account auth record for this
+ // session, so cache clearing and record deletion below are scoped to the correct account.
+ var accountKey = authContext?.LoginHint;
+
// Identify the account that signed in for this session so cache clearing can be scoped to
// it. Prefer the HomeAccountId captured on the session's auth context (set at sign-in) for
// correct isolation when multiple identities share the per-user persisted store. Fall back
// to the persisted auth record, then to clearing all accounts when neither is available.
var homeAccountId = !string.IsNullOrEmpty(authContext?.HomeAccountId)
? authContext.HomeAccountId
- : await GetCurrentHomeAccountIdAsync().ConfigureAwait(false);
+ : await GetCurrentHomeAccountIdAsync(accountKey).ConfigureAwait(false);
if (authContext?.ContextScope == ContextScope.CurrentUser)
{
@@ -484,7 +581,7 @@ await TokenCacheUtilities.ClearPersistedTokenCacheAsync(
GraphSession.Instance.AuthContext = null;
GraphSession.Instance.GraphHttpClient = null;
- await DeleteAuthRecordAsync().ConfigureAwait(false);
+ await DeleteAuthRecordAsync(accountKey).ConfigureAwait(false);
return authContext;
}
@@ -553,11 +650,11 @@ private static async Task ClearBrokerTokenCacheAsync(IAuthContext authContext, s
/// Reads the HomeAccountId of the account persisted for the current session, if any.
/// Returns null when no authentication record is available or it cannot be read.
///
- private static async Task GetCurrentHomeAccountIdAsync()
+ private static async Task GetCurrentHomeAccountIdAsync(string accountKey = null)
{
try
{
- var authRecord = await ReadAuthRecordAsync().ConfigureAwait(false);
+ var authRecord = await ReadAuthRecordAsync(accountKey).ConfigureAwait(false);
return TryGetHomeAccountId(authRecord);
}
catch
@@ -601,29 +698,57 @@ private static void LogCacheClearFailure(string summary, Exception ex)
}
}
- private static async Task ReadAuthRecordAsync()
+ internal static async Task ReadAuthRecordAsync(string accountKey = null)
{
// Try to create directory if it doesn't exist.
Directory.CreateDirectory(Constants.GraphDirectoryPath);
- if (!File.Exists(Constants.AuthRecordPath))
+ var authRecordPath = GetAuthRecordPath(accountKey);
+ if (!File.Exists(authRecordPath))
return null;
- using (FileStream authRecordStream = new FileStream(Constants.AuthRecordPath, FileMode.Open, FileAccess.Read))
+ using (FileStream authRecordStream = new FileStream(authRecordPath, FileMode.Open, FileAccess.Read))
return await AuthenticationRecord.DeserializeAsync(authRecordStream).ConfigureAwait(false);
}
- public static async Task WriteAuthRecordAsync(AuthenticationRecord authRecord)
+ public static async Task WriteAuthRecordAsync(AuthenticationRecord authRecord, string accountKey = null)
{
// Try to create directory if it doesn't exist.
Directory.CreateDirectory(Constants.GraphDirectoryPath);
- using (FileStream authRecordStream = new FileStream(Constants.AuthRecordPath, FileMode.Create, FileAccess.Write))
+ using (FileStream authRecordStream = new FileStream(GetAuthRecordPath(accountKey), FileMode.Create, FileAccess.Write))
await authRecord.SerializeAsync(authRecordStream).ConfigureAwait(false);
}
- public static Task DeleteAuthRecordAsync()
+ public static Task DeleteAuthRecordAsync(string accountKey = null)
{
- if (File.Exists(Constants.AuthRecordPath))
- File.Delete(Constants.AuthRecordPath);
+ var authRecordPath = GetAuthRecordPath(accountKey);
+ if (File.Exists(authRecordPath))
+ File.Delete(authRecordPath);
return Task.CompletedTask;
}
+
+ ///
+ /// Resolves the on-disk path of the persisted for a given
+ /// account. When is null or empty the shared, legacy record path
+ /// () is returned to preserve backwards compatibility for
+ /// sign-ins without a login hint. Otherwise a per-account file is used so that a hinted sign-in
+ /// reuses only that account's record (avoiding silent reuse of a different user's record and
+ /// enabling picker-free repeat sign-ins). The account key is normalized (trimmed, lower-cased)
+ /// and hashed so the file name is stable, case-insensitive, filesystem-safe, and does not embed
+ /// the user's identifier in clear text.
+ ///
+ internal static string GetAuthRecordPath(string accountKey)
+ {
+ if (string.IsNullOrWhiteSpace(accountKey))
+ return Constants.AuthRecordPath;
+
+ var normalized = accountKey.Trim().ToLowerInvariant();
+ using (var sha256 = SHA256.Create())
+ {
+ var hashBytes = sha256.ComputeHash(Encoding.UTF8.GetBytes(normalized));
+ var builder = new StringBuilder(hashBytes.Length * 2);
+ foreach (var b in hashBytes)
+ builder.Append(b.ToString("x2", CultureInfo.InvariantCulture));
+ return Path.Combine(Constants.GraphDirectoryPath, $"mg.authrecord.{builder}.json");
+ }
+ }
}
}
\ No newline at end of file
diff --git a/src/Authentication/Authentication.Test/Helpers/AuthenticationHelpersTests.cs b/src/Authentication/Authentication.Test/Helpers/AuthenticationHelpersTests.cs
index a91eef30e3..1cb4b64fbb 100644
--- a/src/Authentication/Authentication.Test/Helpers/AuthenticationHelpersTests.cs
+++ b/src/Authentication/Authentication.Test/Helpers/AuthenticationHelpersTests.cs
@@ -6,6 +6,7 @@
using Microsoft.Graph.PowerShell.Authentication.Core.Utilities;
using System;
using System.Globalization;
+using System.IO;
using System.Linq;
using System.Net.Http;
using System.Runtime.InteropServices;
@@ -119,6 +120,43 @@ public async Task ShouldUseInteractiveProviderWhenDelegatedAsync()
GraphSession.Reset();
}
+ [Fact]
+ public async Task ShouldCreateInteractiveBrowserCredentialWhenLoginHintIsProvidedAsync()
+ {
+ // Arrange
+ AuthContext delegatedAuthContext = new AuthContext
+ {
+ AuthType = AuthenticationType.Delegated,
+ Scopes = new[] { "User.Read" },
+ ContextScope = ContextScope.Process,
+ TokenCredentialType = TokenCredentialType.InteractiveBrowser,
+ LoginHint = "user@contoso.com"
+ };
+
+ // A per-account record for the hinted user lets the credential be built silently
+ // (no interactive browser / broker call) so the code path is exercised in-process.
+ var record = await BuildAuthRecordAsync("user@contoso.com").ConfigureAwait(false);
+ await AuthenticationHelpers.WriteAuthRecordAsync(record, "user@contoso.com").ConfigureAwait(false);
+ var keyedPath = AuthenticationHelpers.GetAuthRecordPath("user@contoso.com");
+
+ try
+ {
+ // Act
+ TokenCredential tokenCredential = await AuthenticationHelpers.GetTokenCredentialAsync(delegatedAuthContext, default);
+
+ // Assert: supplying a LoginHint must not break interactive credential creation.
+ _ = Assert.IsType(tokenCredential);
+ Assert.Equal("user@contoso.com", delegatedAuthContext.LoginHint);
+ }
+ finally
+ {
+ if (File.Exists(keyedPath))
+ File.Delete(keyedPath);
+ // reset static instance.
+ GraphSession.Reset();
+ }
+ }
+
[Fact]
public async Task ShouldUseInteractiveAuthenticationProviderWhenDelegatedContextAndClientIdIsProvidedAsync()
{
@@ -659,6 +697,102 @@ public override ValueTask GetTokenAsync(TokenRequestContext request
}
}
+ [Fact]
+ public void GetAuthRecordPathReturnsLegacyPathWhenNoAccountKey()
+ {
+ Assert.Equal(PowerShell.Authentication.Core.Constants.AuthRecordPath, AuthenticationHelpers.GetAuthRecordPath(null));
+ Assert.Equal(PowerShell.Authentication.Core.Constants.AuthRecordPath, AuthenticationHelpers.GetAuthRecordPath(string.Empty));
+ Assert.Equal(PowerShell.Authentication.Core.Constants.AuthRecordPath, AuthenticationHelpers.GetAuthRecordPath(" "));
+ }
+
+ [Fact]
+ public void GetAuthRecordPathReturnsStablePerAccountPath()
+ {
+ var path = AuthenticationHelpers.GetAuthRecordPath("user@contoso.com");
+
+ Assert.NotEqual(PowerShell.Authentication.Core.Constants.AuthRecordPath, path);
+ Assert.Equal(PowerShell.Authentication.Core.Constants.GraphDirectoryPath, Path.GetDirectoryName(path));
+ var fileName = Path.GetFileName(path);
+ Assert.StartsWith("mg.authrecord.", fileName);
+ Assert.EndsWith(".json", fileName);
+
+ // Casing and surrounding whitespace must resolve to the same file.
+ Assert.Equal(path, AuthenticationHelpers.GetAuthRecordPath(" USER@Contoso.COM "));
+ // Different accounts must resolve to different files.
+ Assert.NotEqual(path, AuthenticationHelpers.GetAuthRecordPath("other@contoso.com"));
+ }
+
+ [Fact]
+ public async Task MatchesLoginHintIsCaseInsensitiveAndRejectsMismatch()
+ {
+ AuthenticationRecord record = await BuildAuthRecordAsync("User@Contoso.com").ConfigureAwait(false);
+
+ Assert.True(AuthenticationHelpers.MatchesLoginHint(record, "user@contoso.com"));
+ Assert.True(AuthenticationHelpers.MatchesLoginHint(record, " USER@CONTOSO.COM "));
+ Assert.False(AuthenticationHelpers.MatchesLoginHint(record, "different@contoso.com"));
+ Assert.False(AuthenticationHelpers.MatchesLoginHint(null, "user@contoso.com"));
+ }
+
+ [Fact]
+ public async Task ResolveInteractiveAuthRecordDoesNotReuseDifferentUsersRecord()
+ {
+ // A saved record exists (legacy path) for a different user than the login hint.
+ await WriteLegacyAuthRecordAsync("alice@contoso.com").ConfigureAwait(false);
+ var keyedPath = AuthenticationHelpers.GetAuthRecordPath("bob@contoso.com");
+ try
+ {
+ var resolved = await AuthenticationHelpers.ResolveInteractiveAuthRecordAsync("bob@contoso.com").ConfigureAwait(false);
+
+ // Must force a fresh interactive sign-in rather than reuse alice's record.
+ Assert.Null(resolved);
+ Assert.False(File.Exists(keyedPath));
+ }
+ finally
+ {
+ if (File.Exists(keyedPath))
+ File.Delete(keyedPath);
+ }
+ }
+
+ [Fact]
+ public async Task ResolveInteractiveAuthRecordMigratesMatchingLegacyRecord()
+ {
+ // A legacy shared record exists for the SAME account as the login hint.
+ await WriteLegacyAuthRecordAsync("carol@contoso.com").ConfigureAwait(false);
+ var keyedPath = AuthenticationHelpers.GetAuthRecordPath("carol@contoso.com");
+ try
+ {
+ Assert.False(File.Exists(keyedPath));
+
+ var resolved = await AuthenticationHelpers.ResolveInteractiveAuthRecordAsync("carol@contoso.com").ConfigureAwait(false);
+
+ Assert.NotNull(resolved);
+ Assert.Equal("carol@contoso.com", resolved.Username);
+ // The matching legacy record is promoted to a per-account record for picker-free reuse.
+ Assert.True(File.Exists(keyedPath));
+ }
+ finally
+ {
+ if (File.Exists(keyedPath))
+ File.Delete(keyedPath);
+ }
+ }
+
+ private static async Task WriteLegacyAuthRecordAsync(string username)
+ {
+ var record = await BuildAuthRecordAsync(username).ConfigureAwait(false);
+ await AuthenticationHelpers.WriteAuthRecordAsync(record).ConfigureAwait(false);
+ }
+
+ private static async Task BuildAuthRecordAsync(string username)
+ {
+ var json = $"{{\"username\":\"{username}\",\"authority\":\"login.windows.net\"," +
+ $"\"homeAccountId\":\"{Guid.NewGuid()}.{Guid.NewGuid()}\"," +
+ $"\"tenantId\":\"{Guid.NewGuid()}\",\"clientId\":\"{Guid.NewGuid()}\",\"version\":\"1.0\"}}";
+ using (var stream = new MemoryStream(Encoding.UTF8.GetBytes(json)))
+ return await AuthenticationRecord.DeserializeAsync(stream).ConfigureAwait(false);
+ }
+
public void Dispose() => mockAuthRecord.DeleteCache();
}
}
diff --git a/src/Authentication/Authentication.Test/Microsoft.Graph.Authentication.Test.csproj b/src/Authentication/Authentication.Test/Microsoft.Graph.Authentication.Test.csproj
index ccaa28e8fb..e9b9fd1a80 100644
--- a/src/Authentication/Authentication.Test/Microsoft.Graph.Authentication.Test.csproj
+++ b/src/Authentication/Authentication.Test/Microsoft.Graph.Authentication.Test.csproj
@@ -2,16 +2,16 @@
net8.0;net472
false
- 2.35.1
+ 2.38.1
-
-
-
+
+
+
all
runtime; build; native; contentfiles; analyzers; buildtransitive
diff --git a/src/Authentication/Authentication/Cmdlets/ConnectMgGraph.cs b/src/Authentication/Authentication/Cmdlets/ConnectMgGraph.cs
index 79177129e8..d3c8cd06ef 100644
--- a/src/Authentication/Authentication/Cmdlets/ConnectMgGraph.cs
+++ b/src/Authentication/Authentication/Cmdlets/ConnectMgGraph.cs
@@ -86,6 +86,10 @@ public class ConnectMgGraph : PSCmdlet, IModuleAssemblyInitializer, IModuleAssem
[Alias("UseDeviceAuthentication", "DeviceCode", "DeviceAuth", "Device")]
public SwitchParameter UseDeviceCode { get; set; }
+ [Parameter(ParameterSetName = Constants.UserParameterSet, Mandatory = false, HelpMessage = HelpMessages.LoginHint)]
+ [ValidateNotNullOrEmpty]
+ public string LoginHint { get; set; }
+
[Parameter(ParameterSetName = Constants.AppCertificateParameterSet, HelpMessage = HelpMessages.ClientTimeout)]
[Parameter(ParameterSetName = Constants.AppSecretCredentialParameterSet, HelpMessage = HelpMessages.ClientTimeout)]
[Parameter(ParameterSetName = Constants.AccessTokenParameterSet, HelpMessage = HelpMessages.ClientTimeout)]
@@ -194,6 +198,8 @@ private async Task ProcessRecordAsync()
// Default to CurrentUser but allow the customer to change this via `-ContextScope`.
authContext.ContextScope = this.IsParameterBound(nameof(ContextScope)) ? ContextScope : ContextScope.CurrentUser;
}
+if (this.IsParameterBound(nameof(LoginHint)) && !string.IsNullOrWhiteSpace(LoginHint))
+ authContext.LoginHint = LoginHint;
authContext.TokenCredentialType = UseDeviceCode ? TokenCredentialType.DeviceCode : TokenCredentialType.InteractiveBrowser;
}
break;
diff --git a/src/Authentication/Authentication/Constants.cs b/src/Authentication/Authentication/Constants.cs
index 47924df784..f3d19e3ad0 100644
--- a/src/Authentication/Authentication/Constants.cs
+++ b/src/Authentication/Authentication/Constants.cs
@@ -43,6 +43,7 @@ public static class HelpMessages
public const string ContextScope = "Determines the scope of authentication context. This accepts `Process` for the current process, or `CurrentUser` for all sessions started by user.";
public const string Environment = "The name of the national cloud environment to connect to. By default global cloud is used.";
public const string UseDeviceCode = "Use device code authentication instead of a browser control.";
+ public const string LoginHint = "The login hint (typically a username or email) used to pre-populate the account field during interactive browser authentication.";
public const string ClientTimeout = "Sets the HTTP client timeout in seconds.";
public const string NoWelcome = "Hides the welcome message.";
public const string Identity = "Login using a Managed Identity.";
diff --git a/src/Authentication/Authentication/Microsoft.Graph.Authentication-help.xml b/src/Authentication/Authentication/Microsoft.Graph.Authentication-help.xml
index 3c8bd5db0d..65bedc3ea3 100644
--- a/src/Authentication/Authentication/Microsoft.Graph.Authentication-help.xml
+++ b/src/Authentication/Authentication/Microsoft.Graph.Authentication-help.xml
@@ -419,8 +419,7 @@ Get-MgUserActivityHistoryItem CrossDeviceExperiences GET /users
All
- To return all possible permissions rather than just those that match the SearchString parameter, specify the All parameter. The
-All parameter may also be used with the PermissionType to enumerate all applicaition permissions or all delegated permissions.
+ To return all possible permissions rather than just those that match the SearchString parameter, specify the All parameter. The All parameter may also be used with the PermissionType to enumerate all application permissions or all delegated permissions.
SwitchParameter
@@ -431,14 +430,7 @@ All parameter may also be used with the PermissionType to enumerate all applicai
Online
- Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions
-by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the
-SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions
-are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous
-invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not
-already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail.
-If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will
-continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
+ Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail. If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
SwitchParameter
@@ -449,9 +441,7 @@ continue to use the updated list for all future invocations of the command even
PermissionType
- Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by
-Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions.
-Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
+ Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions. Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
String
@@ -478,10 +468,7 @@ Other valid values for PermissionType are Application and Delegated to return th
SearchString
- The SearchString parameter allows you to specify a string such as 'user' or 'mail' that represents the subject or domain
-of the permission you're searching for. Since permissions usually have names such as 'User.Read' or 'Mail.ReadWrite', the
-command uses the SearchString parameter to return all permissions that contain the value specified for SearchString in the
-name of the permission.
+ The SearchString parameter allows you to specify a string such as 'user' or 'mail' that represents the subject or domain of the permission you're searching for. Since permissions usually have names such as 'User.Read' or 'Mail.ReadWrite', the command uses the SearchString parameter to return all permissions that contain the value specified for SearchString in the name of the permission.
String
@@ -504,14 +491,7 @@ name of the permission.
Online
- Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions
-by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the
-SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions
-are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous
-invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not
-already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail.
-If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will
-continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
+ Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail. If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
SwitchParameter
@@ -522,9 +502,7 @@ continue to use the updated list for all future invocations of the command even
PermissionType
- Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by
-Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions.
-Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
+ Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions. Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
String
@@ -551,8 +529,7 @@ Other valid values for PermissionType are Application and Delegated to return th
All
- To return all possible permissions rather than just those that match the SearchString parameter, specify the All parameter. The
-All parameter may also be used with the PermissionType to enumerate all applicaition permissions or all delegated permissions.
+ To return all possible permissions rather than just those that match the SearchString parameter, specify the All parameter. The All parameter may also be used with the PermissionType to enumerate all applicaition permissions or all delegated permissions.
SwitchParameter
@@ -576,14 +553,7 @@ All parameter may also be used with the PermissionType to enumerate all applicai
Online
- Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions
-by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the
-SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions
-are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous
-invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not
-already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail.
-If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will
-continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
+ Specify the Online parameter in addition to SearchString to force Find-MgGraphPermission to update its set of permissions by requesting the latest permissions data from Microsoft Graph itself before searching for the permissions specified the SearchString parameter. This ensures that Find-MgGraphPermission returns the most accurate search results as new permissions are added to Microsoft Graph for new APIs. The command uses the existing access to Microsoft Graph as enabled by a previous invocation of the Connect-MgGraph command to issue the request for updated permissions. If your current connection does not already have access to read this data from Microsoft Graph or if there is no network connectivity to Microsoft Graph, the command will fail. If the command is successful in updating the set of permissions prior to searching for permissions, Find-MgGraphPermission will continue to use the updated list for all future invocations of the command even if they do not specify the Online parameter
SwitchParameter
@@ -595,9 +565,7 @@ continue to use the updated list for all future invocations of the command even
PermissionType
- Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by
-Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions.
-Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
+ Specify the PermissionType to determine whether application permissions, delegated permisisons, or both are returned by Find-MgGraphPermission. By default, the value of this parameter is Any, which includes both delegated and application permissions. Other valid values for PermissionType are Application and Delegated to return those specify types of permissions.
String
@@ -621,10 +589,7 @@ Other valid values for PermissionType are Application and Delegated to return th
SearchString
- The SearchString parameter allows you to specify a string such as 'user' or 'mail' that represents the subject or domain
-of the permission you're searching for. Since permissions usually have names such as 'User.Read' or 'Mail.ReadWrite', the
-command uses the SearchString parameter to return all permissions that contain the value specified for SearchString in the
-name of the permission.
+ The SearchString parameter allows you to specify a string such as 'user' or 'mail' that represents the subject or domain of the permission you're searching for. Since permissions usually have names such as 'User.Read' or 'Mail.ReadWrite', the command uses the SearchString parameter to return all permissions that contain the value specified for SearchString in the name of the permission.
String
diff --git a/src/Authentication/Authentication/Microsoft.Graph.Authentication.csproj b/src/Authentication/Authentication/Microsoft.Graph.Authentication.csproj
index 7f6e32952a..6d5e8c5a4b 100644
--- a/src/Authentication/Authentication/Microsoft.Graph.Authentication.csproj
+++ b/src/Authentication/Authentication/Microsoft.Graph.Authentication.csproj
@@ -10,7 +10,7 @@
Microsoft.Graph.Authentication.nuspec
© Microsoft Corporation. All rights reserved.
- 2.35.1
+ 2.38.1
true
diff --git a/src/Authentication/Authentication/Microsoft.Graph.Authentication.dll-Help.xml b/src/Authentication/Authentication/Microsoft.Graph.Authentication.dll-Help.xml
index 5df68dcb55..e4fdd92455 100644
--- a/src/Authentication/Authentication/Microsoft.Graph.Authentication.dll-Help.xml
+++ b/src/Authentication/Authentication/Microsoft.Graph.Authentication.dll-Help.xml
@@ -6,11 +6,11 @@
Add
MgEnvironment
- {{ Fill in the Synopsis }}
+ Adds Microsoft Graph environment to the settings file.
- {{ Fill in the Description }}
+ Adds Microsoft Graph environment to the settings file.
@@ -51,6 +51,18 @@
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -112,6 +124,18 @@
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -164,10 +188,13 @@
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ ----------- Example 1: Add user defined environment -----------
+ PS C:\> Add-MgEnvironment -Name "Canary" -GraphEndpoint "https://canary.graph.microsoft.com" -AzureADEndpoint "https://login.microsoftonline.com"
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+Canary https://login.microsoftonline.com https://microsoftgraph.com User-defined
- {{ Add example description here }}
+ Adds user defined environment.
@@ -240,6 +267,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Connect-MgGraph
@@ -342,6 +381,30 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
+
+ SendCertificateChain
+
+ Include x5c header in client claims when acquiring a token to enable subject name / issuer based authentication using given certificate.
+
+ Boolean
+
+ Boolean
+
+
+ None
+
TenantId
@@ -421,6 +484,18 @@
None
+
+ LoginHint
+
+ The login hint (typically a username or email) used to pre-populate the account field during interactive browser authentication.
+
+ String
+
+ String
+
+
+ None
+
NoWelcome
@@ -432,6 +507,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
TenantId
@@ -532,6 +619,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Connect-MgGraph
@@ -598,6 +697,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
TenantId
@@ -675,6 +786,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
@@ -810,6 +933,18 @@
False
+
+ LoginHint
+
+ The login hint (typically a username or email) used to pre-populate the account field during interactive browser authentication.
+
+ String
+
+ String
+
+
+ None
+
NoWelcome
@@ -822,6 +957,18 @@
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Scopes
@@ -834,6 +981,18 @@
None
+
+ SendCertificateChain
+
+ Include x5c header in client claims when acquiring a token to enable subject name / issuer based authentication using given certificate.
+
+ Boolean
+
+ Boolean
+
+
+ None
+
TenantId
@@ -961,24 +1120,49 @@ PS C:\> Connect-MgGraph -TenantId "Tenant_Id" -ClientSecretCredential $Client
------ Example 11: Connecting to an environment or cloud ------
PS C:\> Get-MgEnvironment
-Name AzureADEndpoint GraphEndpoint Type
----- --------------- ------------- ----
-China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
-Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
-USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
-USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+BleuCloud https://login.sovcloud-identity.fr https://graph.svc.sovcloud.fr Built-in
+China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud https://login.sovcloud-identity.de https://graph.svc.sovcloud.de Built-in
+Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
+GovSGCloud https://login.sovcloud-identity.sg https://graph.svc.sovcloud.sg Built-in
+USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
+USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
PS C:\> Connect-MgGraph -Environment USGov
When you use Connect-MgGraph, you can choose to target other environments. By default, Connect-MgGraph targets the global public cloud.
- Example 12: Connecting to an environment as a different identity
+ Example 12: Connecting to a sovereign cloud with a custom application
+ PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud -Scopes "User.Read.All"
+
+ Sovereign cloud environments (BleuCloud, DelosCloud, GovSGCloud) require a custom application registration. You cannot use the default Microsoft Graph PowerShell application in these environments. When registering your application, add an additional redirect URI of `ms-appx-web://Microsoft.AAD.BrokerPlugin/<YOUR_APP_CLIENT_ID>` to support WAM broker-based authentication. Requires Microsoft.Graph.Authentication v2.36.1 or later.
+
+
+
+ Example 13: Connecting to a sovereign cloud when WAM authentication hangs
+ PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
+
+ If the authentication popup hangs or times out when connecting to a sovereign cloud (for example, from a jumpbox), WAM broker-based login may not work in that environment. Disable WAM to use interactive browser sign-in instead. You only need to run `Set-MgGraphOption -DisableLoginByWAM $true` once; the setting persists across sessions.
+
+
+
+ Example 14: Connecting to an environment as a different identity
PS C:\> Connect-MgGraph -ContextScope Process
To connect as a different identity other than CurrentUser, specify the -ContextScope parameter with the value Process.
+
+ Example 15: Delegated access: Pre-populating the account during interactive sign-in
+ PS C:\> Connect-MgGraph -Scopes "User.Read.All" -LoginHint "user@contoso.com"
+
+ Use the -LoginHint parameter to pre-populate the account (login_hint) shown in the interactive browser sign-in prompt. On Windows, WAM may still display the account picker on the first sign-in for an account; later sign-ins with the same -LoginHint are silent.
+
+
@@ -997,14 +1181,62 @@ PS C:\> Connect-MgGraph -Environment USGov
- Use Disconnect-MgGraph to sign out.
+ Use Disconnect-MgGraph to sign out. This clears the persisted MSAL token cache from disk when using CurrentUser context scope, as well as removing the in-memory token cache and authentication record. Use the -SignOutFromBroker switch to additionally remove cached accounts from the Windows broker (WAM); note that the broker store is shared at the OS level, so this can also sign you out of other broker-enabled applications (for example Visual Studio, Azure CLI, or Azure PowerShell) that use the same Windows account.
Disconnect-MgGraph
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
+
+ SignOutFromBroker
+
+ Also removes cached accounts from the Windows broker (WAM). This is a shared, OS-level store, so it may sign you out of other broker-enabled applications (e.g. Visual Studio, Azure CLI, Azure PowerShell) using the same Windows account.
+
+
+ SwitchParameter
+
+
+ False
+
-
+
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
+
+ SignOutFromBroker
+
+ Also removes cached accounts from the Windows broker (WAM). This is a shared, OS-level store, so it may sign you out of other broker-enabled applications (e.g. Visual Studio, Azure CLI, Azure PowerShell) using the same Windows account.
+
+ SwitchParameter
+
+ SwitchParameter
+
+
+ False
+
+
@@ -1038,6 +1270,13 @@ PS C:\> Connect-MgGraph -Environment USGov
Use Disconnect-MgGraph to sign out.
+
+ Example 2: Sign out and also clear the Windows broker (WAM) cache
+ PS C:\> Disconnect-MgGraph -SignOutFromBroker
+
+ Signs out and additionally removes cached accounts from the Windows broker (WAM). Because the broker store is shared at the OS level, this can also sign you out of other broker-enabled applications (for example Visual Studio, Azure CLI, or Azure PowerShell) using the same Windows account.
+
+
@@ -1061,9 +1300,34 @@ PS C:\> Connect-MgGraph -Environment USGov
Get-MgContext
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
-
+
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
+
@@ -1163,6 +1427,18 @@ User.ReadWrite.All
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
@@ -1178,6 +1454,18 @@ User.ReadWrite.All
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
@@ -1208,12 +1496,15 @@ User.ReadWrite.All
----------------- Example 1: Get-MgEnvironment -----------------
PS C:\> Get-MgEnvironment
-Name AzureADEndpoint GraphEndpoint Type
----- --------------- ------------- ----
-China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
-Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
-USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
-USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+BleuCloud https://login.sovcloud-identity.fr https://graph.svc.sovcloud.fr Built-in
+China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud https://login.sovcloud-identity.de https://graph.svc.sovcloud.de Built-in
+Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
+GovSGCloud https://login.sovcloud-identity.sg https://graph.svc.sovcloud.sg Built-in
+USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
+USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
This command gets list of all environments.
@@ -1232,18 +1523,43 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
Get
MgGraphOption
- {{ Fill in the Synopsis }}
+ Gets global configurations that apply to the SDK. For example, check if Web Account Manager (WAM) support has been enabled.
- {{ Fill in the Description }}
+ Gets global configurations that apply to the SDK. For example, check if Web Account Manager (WAM) support has been enabled.
Get-MgGraphOption
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
-
+
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
+
@@ -1266,15 +1582,18 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
-
+ Web Account Manager is enabled by default on Windows systems and cannot be disabled. Setting the `EnableWAMForMSGraph` option no longer has any effect.
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ ------- Example 1: Check if WAM support has been enabled -------
+ PS C:\> Get-MgGraphOption
+EnableWAMForMSGraph
+--------------------
+ True
- {{ Add example description here }}
+ Confirms if WAM support has been enabled. Web Account Manager is enabled by default on Windows systems and cannot be disabled.
@@ -1291,15 +1610,27 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
Get
MgRequestContext
- {{ Fill in the Synopsis }}
+ Gets graph request context details
- {{ Fill in the Description }}
+ Gets graph request context details
Get-MgRequestContext
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -1325,6 +1656,18 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -1377,10 +1720,13 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ ---------------- Example 1: Get request context ----------------
+ PS C:\> Get-MgRequestContext
+ClientTimeout RetryDelay MaxRetry RetriesTimeLimit
+------------- ---------- -------- ----------------
+00:00:05 3 2 00:00:02
- {{ Add example description here }}
+ Gets graph request context details
@@ -1619,6 +1965,18 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
@@ -1742,6 +2100,18 @@ USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us
False
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
ResponseHeadersVariable
@@ -1888,11 +2258,11 @@ surname Administrator
Remove
MgEnvironment
- {{ Fill in the Synopsis }}
+ Removes Microsoft Graph environment to the settings file
- {{ Fill in the Description }}
+ Removes Microsoft Graph environment to the settings file
@@ -1909,6 +2279,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -1946,6 +2328,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -1998,10 +2392,13 @@ surname Administrator
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ ---------- Example 1: Remove user-defined environment ----------
+ PS C:\> Remove-MgEnvironment Canary
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+Canary https://login.microsoftonline.com https://microsoftgraph.com User-defined
- {{ Add example description here }}
+ Removes user-defined environment.
@@ -2018,11 +2415,11 @@ surname Administrator
Set
MgEnvironment
- {{ Fill in the Synopsis }}
+ Sets a Microsoft Graph environment to the settings file.
- {{ Fill in the Description }}
+ Sets a Microsoft Graph environment to the settings file.
@@ -2063,6 +2460,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -2124,6 +2533,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
Confirm
@@ -2176,10 +2597,10 @@ surname Administrator
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ ------ Example 1: Set environment for the current session ------
+ PS C:\> Set-MgEnvironment -GraphEndpoint "https://canary.graph.microsoft.com" -AzureADEndpoint "https://login.microsoftonline.com"
- {{ Add example description here }}
+ Sets the environment for the current session.
@@ -2196,19 +2617,19 @@ surname Administrator
Set
MgGraphOption
- {{ Fill in the Synopsis }}
+ Sets global configurations that apply to the SDK. For example, toggle Web Account Manager (WAM) support.
- {{ Fill in the Description }}
+ Sets global configurations that apply to the SDK. For example, toggle Web Account Manager (WAM) support.
Set-MgGraphOption
- EnableLoginByWAM
+ DisableLoginByWAM
- {{ Fill EnableLoginByWAM Description }}
+ Disables sign in via Web Account Manager (WAM). Note: This only takes effect when using a custom ClientId. When using the default ClientId, WAM remains enabled regardless of this setting.
Boolean
@@ -2217,13 +2638,25 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
- EnableLoginByWAM
+ DisableLoginByWAM
- {{ Fill EnableLoginByWAM Description }}
+ Disables sign in via Web Account Manager (WAM). Note: This only takes effect when using a custom ClientId. When using the default ClientId, WAM remains enabled regardless of this setting.
Boolean
@@ -2232,6 +2665,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
@@ -2260,10 +2705,18 @@ surname Administrator
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ -------- Example 1: Disable web account manager support --------
+ PS C:\> Set-MgGraphOption -DisableLoginByWAM $True
+
+ Disables sign in via Web Account Manager (WAM). Note: This only takes effect when using a custom ClientId. When using the default ClientId, WAM remains enabled regardless of this setting.
+
+
+
+ --- Example 2: Disable WAM for sovereign cloud environments ---
+ PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
- {{ Add example description here }}
+ If WAM broker-based authentication hangs or times out when connecting to a sovereign cloud environment (such as BleuCloud, DelosCloud, or GovSGCloud), disable WAM to fall back to interactive browser sign-in. This can occur when authenticating from environments like jumpboxes. The setting persists across PowerShell sessions.
@@ -2280,11 +2733,11 @@ surname Administrator
Set
MgRequestContext
- {{ Fill in the Synopsis }}
+ Sets request context for Microsoft Graph invocations
- {{ Fill in the Description }}
+ Sets request context for Microsoft Graph invocations
@@ -2313,6 +2766,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
RetriesTimeLimit
@@ -2386,6 +2851,18 @@ surname Administrator
None
+
+ ProgressAction
+
+ Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+ ActionPreference
+
+ ActionPreference
+
+
+ None
+
RetriesTimeLimit
@@ -2462,10 +2939,43 @@ surname Administrator
- -------------------------- Example 1 --------------------------
- PS C:\> {{ Add example code here }}
+ -------- Example 1: Set Http client timeout in seconds --------
+ PS C:\> Set-MgRequestContext -ClientTimeout 5
+ClientTimeout RetryDelay MaxRetry RetriesTimeLimit
+------------- ---------- -------- ----------------
+00:00:05 3 2 00:00:00
+
+ Sets Http client timeout in seconds.
+
+
+
+ Example 2: Set the maximum time in seconds allowed for request retries
+ PS C:\> Set-MgRequestContext -RetriesTimeLimit 2
+ClientTimeout RetryDelay MaxRetry RetriesTimeLimit
+------------- ---------- -------- ----------------
+00:00:05 3 2 00:00:02
+
+ Sets the maximum time in seconds allowed for request retries.
+
+
+
+ -- Example 3: Set the maximum number of retries for a request --
+ PS C:\> Set-MgRequestContext -MaxRetry 2
+ClientTimeout RetryDelay MaxRetry RetriesTimeLimit
+------------- ---------- -------- ----------------
+00:00:05 3 2 00:00:02
+
+ Sets the maximum number of retries for a request.
+
+
+
+ Example 4: Set the waiting time in seconds before retrying a request
+ PS C:\> Set-MgRequestContext -RetryDelay 3
+ClientTimeout RetryDelay MaxRetry RetriesTimeLimit
+------------- ---------- -------- ----------------
+00:00:05 3 2 00:00:02
- {{ Add example description here }}
+ Sets the waiting time in seconds before retrying a request.
diff --git a/src/Authentication/Authentication/Microsoft.Graph.Authentication.nuspec b/src/Authentication/Authentication/Microsoft.Graph.Authentication.nuspec
index 0fb359f1c2..9f481d84af 100644
--- a/src/Authentication/Authentication/Microsoft.Graph.Authentication.nuspec
+++ b/src/Authentication/Authentication/Microsoft.Graph.Authentication.nuspec
@@ -1,7 +1,7 @@
- 2.35.1
+ 2.38.1
Microsoft.Graph.Authentication
Microsoft Graph PowerShell authentication module
Microsoft
diff --git a/src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1 b/src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1
index 1373f08ec3..b935343b60 100644
--- a/src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1
+++ b/src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1
@@ -3,7 +3,7 @@
#
# Generated by: Microsoft
#
-# Generated on: 21/09/2023
+# Generated on: 7/16/2026
#
@{
@@ -12,7 +12,7 @@
RootModule = './Microsoft.Graph.Authentication.psm1'
# Version number of this module.
-ModuleVersion = '2.6.1'
+ModuleVersion = '2.38.1'
# Supported PSEditions
CompatiblePSEditions = 'Core', 'Desktop'
@@ -133,3 +133,4 @@ PrivateData = @{
# DefaultCommandPrefix = ''
}
+
diff --git a/src/Authentication/Authentication/Models/AuthContext.cs b/src/Authentication/Authentication/Models/AuthContext.cs
index 94fc9aabef..bc8ca0f88a 100644
--- a/src/Authentication/Authentication/Models/AuthContext.cs
+++ b/src/Authentication/Authentication/Models/AuthContext.cs
@@ -21,6 +21,7 @@ public class AuthContext : IAuthContext
public string CertificateSubjectName { get; set; }
public bool SendCertificateChain { get; set; }
public string Account { get; set; }
+ public string LoginHint { get; set; }
public string HomeAccountId { get; set; }
public string AppName { get; set; }
public ContextScope ContextScope { get; set; }
diff --git a/src/Authentication/Authentication/test/Connect-MgGraph.Tests.ps1 b/src/Authentication/Authentication/test/Connect-MgGraph.Tests.ps1
index 382ad62a98..de52fcaef5 100644
--- a/src/Authentication/Authentication/test/Connect-MgGraph.Tests.ps1
+++ b/src/Authentication/Authentication/test/Connect-MgGraph.Tests.ps1
@@ -22,7 +22,15 @@ Describe 'Connect-MgGraph ParameterSets' {
$UserParameterSet | Should -Not -BeNull
$UserParameterSet.IsDefault | Should -BeTrue
$UserParameterSet.Parameters | Where-Object IsMandatory | Should -HaveCount 0
- @('ClientId', 'TenantId', 'ContextScope', 'Environment', 'ClientTimeout') | Should -BeIn $UserParameterSet.Parameters.Name
+ @('ClientId', 'TenantId', 'ContextScope', 'Environment', 'ClientTimeout', 'LoginHint') | Should -BeIn $UserParameterSet.Parameters.Name
+ }
+
+ It 'Should have an optional LoginHint parameter only in UserParameterSet' {
+ $LoginHintParameter = $ConnectMgGraphCommand.Parameters['LoginHint']
+ $LoginHintParameter | Should -Not -BeNull
+ $LoginHintParameter.ParameterType | Should -Be ([string])
+ $LoginHintParameter.ParameterSets.Keys | Should -Be 'UserParameterSet'
+ $LoginHintParameter.ParameterSets['UserParameterSet'].IsMandatory | Should -BeFalse
}
It 'Should have AppCertificateParameterSet' {
diff --git a/src/Authentication/docs/Add-MgEnvironment.md b/src/Authentication/docs/Add-MgEnvironment.md
index b2cec82695..335905cb59 100644
--- a/src/Authentication/docs/Add-MgEnvironment.md
+++ b/src/Authentication/docs/Add-MgEnvironment.md
@@ -13,8 +13,8 @@ schema: 2.0.0
## SYNTAX
```
-Add-MgEnvironment [-Name] [-AzureADEndpoint] [-GraphEndpoint] [-WhatIf] [-Confirm]
- []
+Add-MgEnvironment [-Name] [-AzureADEndpoint] [-GraphEndpoint]
+ [-ProgressAction ] [-WhatIf] [-Confirm] []
```
## DESCRIPTION
@@ -79,6 +79,21 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -Confirm
Prompts you for confirmation before running the cmdlet.
@@ -116,14 +131,13 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## INPUTS
### System.String
-
## OUTPUTS
### Microsoft.Graph.PowerShell.Authentication.Models.GraphEnvironment
-
## NOTES
## RELATED LINKS
[https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.authentication/add-mgenvironment](https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.authentication/add-mgenvironment)
+
diff --git a/src/Authentication/docs/Connect-MgGraph.md b/src/Authentication/docs/Connect-MgGraph.md
index 9ef5d0af7c..24d5d50faa 100644
--- a/src/Authentication/docs/Connect-MgGraph.md
+++ b/src/Authentication/docs/Connect-MgGraph.md
@@ -15,39 +15,41 @@ Microsoft Graph PowerShell supports two types of authentication: delegated and a
### UserParameterSet (Default)
```
Connect-MgGraph [[-Scopes] ] [[-ClientId] ] [-TenantId ]
- [-ContextScope ] [-Environment ] [-UseDeviceCode] [-ClientTimeout ] [-NoWelcome]
- []
+ [-ContextScope ] [-Environment ] [-UseDeviceCode] [-LoginHint ]
+ [-ClientTimeout ] [-NoWelcome] [-ProgressAction ] []
```
### AppCertificateParameterSet
```
Connect-MgGraph [-ClientId] [[-CertificateSubjectName] ] [[-CertificateThumbprint] ]
- [-Certificate ] [-TenantId ] [-ContextScope ] [-Environment ]
- [-ClientTimeout ] [-NoWelcome] []
+ [-SendCertificateChain ] [-Certificate ] [-TenantId ]
+ [-ContextScope ] [-Environment ] [-ClientTimeout ] [-NoWelcome]
+ [-ProgressAction ] []
```
### IdentityParameterSet
```
Connect-MgGraph [[-ClientId] ] [-ContextScope ] [-Environment ]
- [-ClientTimeout ] [-Identity] [-NoWelcome] []
+ [-ClientTimeout ] [-Identity] [-NoWelcome] [-ProgressAction ] []
```
### AppSecretCredentialParameterSet
```
Connect-MgGraph [-ClientSecretCredential ] [-TenantId ] [-ContextScope ]
- [-Environment ] [-ClientTimeout ] [-NoWelcome] []
+ [-Environment ] [-ClientTimeout ] [-NoWelcome] [-ProgressAction ]
+ []
```
### AccessTokenParameterSet
```
Connect-MgGraph [-AccessToken] [-Environment ] [-ClientTimeout ] [-NoWelcome]
- []
+ [-ProgressAction ] []
```
### EnvironmentVariableParameterSet
```
Connect-MgGraph [-ContextScope ] [-Environment ] [-ClientTimeout ]
- [-EnvironmentVariable] [-NoWelcome] []
+ [-EnvironmentVariable] [-NoWelcome] [-ProgressAction ] []
```
## DESCRIPTION
@@ -131,24 +133,50 @@ Uses a user created managed identity as a standalone Azure resource.
### Example 11: Connecting to an environment or cloud
```powershell
PS C:\> Get-MgEnvironment
-Name AzureADEndpoint GraphEndpoint Type
----- --------------- ------------- ----
-China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
-Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
-USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
-USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+BleuCloud https://login.sovcloud-identity.fr https://graph.svc.sovcloud.fr Built-in
+China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud https://login.sovcloud-identity.de https://graph.svc.sovcloud.de Built-in
+Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
+GovSGCloud https://login.sovcloud-identity.sg https://graph.svc.sovcloud.sg Built-in
+USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
+USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
PS C:\> Connect-MgGraph -Environment USGov
```
When you use Connect-MgGraph, you can choose to target other environments. By default, Connect-MgGraph targets the global public cloud.
-### Example 12: Connecting to an environment as a different identity
+### Example 12: Connecting to a sovereign cloud with a custom application
+```powershell
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud -Scopes "User.Read.All"
+```
+
+Sovereign cloud environments (BleuCloud, DelosCloud, GovSGCloud) require a custom application registration. You cannot use the default Microsoft Graph PowerShell application in these environments. When registering your application, add an additional redirect URI of `ms-appx-web://Microsoft.AAD.BrokerPlugin/` to support WAM broker-based authentication. Requires Microsoft.Graph.Authentication v2.36.1 or later.
+
+### Example 13: Connecting to a sovereign cloud when WAM authentication hangs
+```powershell
+PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
+```
+
+If the authentication popup hangs or times out when connecting to a sovereign cloud (for example, from a jumpbox), WAM broker-based login may not work in that environment. Disable WAM to use interactive browser sign-in instead. You only need to run `Set-MgGraphOption -DisableLoginByWAM $true` once; the setting persists across sessions.
+
+### Example 14: Connecting to an environment as a different identity
```powershell
PS C:\> Connect-MgGraph -ContextScope Process
```
To connect as a different identity other than CurrentUser, specify the -ContextScope parameter with the value Process.
+### Example 15: Delegated access: Pre-populating the account during interactive sign-in
+```powershell
+PS C:\> Connect-MgGraph -Scopes "User.Read.All" -LoginHint "user@contoso.com"
+```
+
+Use the -LoginHint parameter to pre-populate the account (login_hint) shown in the interactive browser sign-in prompt.
+On Windows, WAM may still display the account picker on the first sign-in for an account; later sign-ins with the same -LoginHint are silent.
+
## PARAMETERS
### -AccessToken
@@ -336,6 +364,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```
+### -LoginHint
+The login hint (typically a username or email) used to pre-populate the account field during interactive browser authentication.
+
+```yaml
+Type: String
+Parameter Sets: UserParameterSet
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -NoWelcome
Hides the welcome message.
@@ -351,6 +394,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -Scopes
An array of delegated permissions to consent to.
@@ -366,6 +424,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```
+### -SendCertificateChain
+Include x5c header in client claims when acquiring a token to enable subject name / issuer based authentication using given certificate.
+
+```yaml
+Type: Boolean
+Parameter Sets: AppCertificateParameterSet
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -TenantId
The id of the tenant to connect to.
You can also use this parameter to specify your sign-in audience.
diff --git a/src/Authentication/docs/Disconnect-MgGraph.md b/src/Authentication/docs/Disconnect-MgGraph.md
index 58db78b868..b37f7d8df0 100644
--- a/src/Authentication/docs/Disconnect-MgGraph.md
+++ b/src/Authentication/docs/Disconnect-MgGraph.md
@@ -37,28 +37,28 @@ Signs out and additionally removes cached accounts from the Windows broker (WAM)
## PARAMETERS
-### -SignOutFromBroker
-Also removes cached accounts for this module from the Windows broker (WAM). Because the broker store is shared at the OS level, this can sign you out of other broker-enabled applications (for example Visual Studio, Azure CLI, or Azure PowerShell) that use the same Windows account. Has no effect when the broker is not in use.
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
```yaml
-Type: SwitchParameter
+Type: ActionPreference
Parameter Sets: (All)
-Aliases:
+Aliases: proga
Required: False
Position: Named
-Default value: False
+Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
-### -ProgressAction
-Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+### -SignOutFromBroker
+Also removes cached accounts from the Windows broker (WAM). This is a shared, OS-level store, so it may sign you out of other broker-enabled applications (e.g. Visual Studio, Azure CLI, Azure PowerShell) using the same Windows account.
```yaml
-Type: ActionPreference
+Type: SwitchParameter
Parameter Sets: (All)
-Aliases: proga
+Aliases:
Required: False
Position: Named
diff --git a/src/Authentication/docs/Get-MgContext.md b/src/Authentication/docs/Get-MgContext.md
index 73205cb296..814e21b319 100644
--- a/src/Authentication/docs/Get-MgContext.md
+++ b/src/Authentication/docs/Get-MgContext.md
@@ -13,7 +13,7 @@ Get-MgContext is used to retrieve the details about your current session, which
## SYNTAX
```
-Get-MgContext []
+Get-MgContext [-ProgressAction ] []
```
## DESCRIPTION
@@ -61,6 +61,21 @@ Retrieves all scopes.
## PARAMETERS
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
diff --git a/src/Authentication/docs/Get-MgEnvironment.md b/src/Authentication/docs/Get-MgEnvironment.md
index bfbeeb85d4..cf8f914c4d 100644
--- a/src/Authentication/docs/Get-MgEnvironment.md
+++ b/src/Authentication/docs/Get-MgEnvironment.md
@@ -13,7 +13,7 @@ When you use Connect-MgGraph, you can choose to target other environments. By de
## SYNTAX
```
-Get-MgEnvironment [[-Name] ] []
+Get-MgEnvironment [[-Name] ] [-ProgressAction ] []
```
## DESCRIPTION
@@ -24,12 +24,15 @@ When you use Connect-MgGraph, you can choose to target other environments. By de
### Example 1: Get-MgEnvironment
```powershell
PS C:\> Get-MgEnvironment
-Name AzureADEndpoint GraphEndpoint Type
----- --------------- ------------- ----
-China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
-Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
-USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
-USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
+Name AzureADEndpoint GraphEndpoint Type
+---- --------------- ------------- ----
+BleuCloud https://login.sovcloud-identity.fr https://graph.svc.sovcloud.fr Built-in
+China https://login.chinacloudapi.cn https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud https://login.sovcloud-identity.de https://graph.svc.sovcloud.de Built-in
+Global https://login.microsoftonline.com https://graph.microsoft.com Built-in
+GovSGCloud https://login.sovcloud-identity.sg https://graph.svc.sovcloud.sg Built-in
+USGov https://login.microsoftonline.us https://graph.microsoft.us Built-in
+USGovDoD https://login.microsoftonline.us https://dod-graph.microsoft.us Built-in
```
This command gets list of all environments.
@@ -51,6 +54,21 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
diff --git a/src/Authentication/docs/Get-MgGraphOption.md b/src/Authentication/docs/Get-MgGraphOption.md
index 3f5c023fb4..60ccb07905 100644
--- a/src/Authentication/docs/Get-MgGraphOption.md
+++ b/src/Authentication/docs/Get-MgGraphOption.md
@@ -13,7 +13,7 @@ Gets global configurations that apply to the SDK. For example, check if Web Acco
## SYNTAX
```
-Get-MgGraphOption []
+Get-MgGraphOption [-ProgressAction ] []
```
## DESCRIPTION
@@ -29,21 +29,34 @@ EnableWAMForMSGraph
True
```
-Confirms if WAM support has been enabled.
+Confirms if WAM support has been enabled. Web Account Manager is enabled by default on Windows systems and cannot be disabled.
## PARAMETERS
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
## INPUTS
### None
-
## OUTPUTS
### Microsoft.Graph.PowerShell.Authentication.IGraphOption
-
## NOTES
Web Account Manager is enabled by default on Windows systems and cannot be disabled. Setting the `EnableWAMForMSGraph` option no longer has any effect.
diff --git a/src/Authentication/docs/Get-MgRequestContext.md b/src/Authentication/docs/Get-MgRequestContext.md
index 57dc617116..cd83532015 100644
--- a/src/Authentication/docs/Get-MgRequestContext.md
+++ b/src/Authentication/docs/Get-MgRequestContext.md
@@ -13,7 +13,7 @@ Gets graph request context details
## SYNTAX
```
-Get-MgRequestContext [-WhatIf] [-Confirm] []
+Get-MgRequestContext [-ProgressAction ] [-WhatIf] [-Confirm] []
```
## DESCRIPTION
@@ -33,6 +33,21 @@ Gets graph request context details
## PARAMETERS
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -Confirm
Prompts you for confirmation before running the cmdlet.
@@ -70,11 +85,9 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## INPUTS
### None
-
## OUTPUTS
### Microsoft.Graph.PowerShell.Authentication.Core.Interfaces.IRequestContext
-
## NOTES
## RELATED LINKS
diff --git a/src/Authentication/docs/Invoke-MgGraphRequest.md b/src/Authentication/docs/Invoke-MgGraphRequest.md
index 5db5c8f361..3897488c22 100644
--- a/src/Authentication/docs/Invoke-MgGraphRequest.md
+++ b/src/Authentication/docs/Invoke-MgGraphRequest.md
@@ -18,7 +18,7 @@ Invoke-MgGraphRequest [[-Method] ] [-Uri] [[-Body] ] [[-SessionVariable] ]
[[-ResponseHeadersVariable] ] [[-StatusCodeVariable] ] [-SkipHttpErrorCheck]
[[-GraphRequestSession] ] [[-UserAgent] ] [[-OutputType] ]
- []
+ [-ProgressAction ] []
```
## DESCRIPTION
@@ -203,6 +203,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -ResponseHeadersVariable
Response Headers Variable
diff --git a/src/Authentication/docs/Microsoft.Graph.Authentication.md b/src/Authentication/docs/Microsoft.Graph.Authentication.md
index c09769b3cc..1c7747b5f6 100644
--- a/src/Authentication/docs/Microsoft.Graph.Authentication.md
+++ b/src/Authentication/docs/Microsoft.Graph.Authentication.md
@@ -1,6 +1,6 @@
---
Module Name: Microsoft.Graph.Authentication
-Module Guid: 0fecf360-9875-4e02-998c-b6d7b6653b6b
+Module Guid: 883916f2-9184-46ee-b1f8-b6a2fb784cee
Download Help Link: https://learn.microsoft.com/powershell/module/Microsoft.Graph.Authentication
Help Version: 1.0.0.0
Locale: en-US
@@ -48,7 +48,7 @@ Removes Microsoft Graph environment to the settings file
Sets a Microsoft Graph environment to the settings file.
### [Set-MgGraphOption](Set-MgGraphOption.md)
-Sets global configurations that apply to the SDK. For example, toggle Web Account Manager (WAM) support. Web Account Manager is enabled by default on Windows systems and cannot be disabled.
+Sets global configurations that apply to the SDK. For example, toggle Web Account Manager (WAM) support.
### [Set-MgRequestContext](Set-MgRequestContext.md)
Sets request context for Microsoft Graph invocations
diff --git a/src/Authentication/docs/Remove-MgEnvironment.md b/src/Authentication/docs/Remove-MgEnvironment.md
index 4fd5c7a044..b8def86950 100644
--- a/src/Authentication/docs/Remove-MgEnvironment.md
+++ b/src/Authentication/docs/Remove-MgEnvironment.md
@@ -13,7 +13,8 @@ Removes Microsoft Graph environment to the settings file
## SYNTAX
```
-Remove-MgEnvironment [-Name] [-WhatIf] [-Confirm] []
+Remove-MgEnvironment [-Name] [-ProgressAction ] [-WhatIf] [-Confirm]
+ []
```
## DESCRIPTION
@@ -48,6 +49,21 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -Confirm
Prompts you for confirmation before running the cmdlet.
@@ -85,14 +101,13 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## INPUTS
### System.String
-
## OUTPUTS
### Microsoft.Graph.PowerShell.Authentication.Models.GraphEnvironment
-
## NOTES
## RELATED LINKS
[https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.authentication/remove-mgenvironment](https://learn.microsoft.com/en-us/powershell/module/microsoft.graph.authentication/remove-mgenvironment)
+
diff --git a/src/Authentication/docs/Set-MgEnvironment.md b/src/Authentication/docs/Set-MgEnvironment.md
index 12e2632fce..7404de1a83 100644
--- a/src/Authentication/docs/Set-MgEnvironment.md
+++ b/src/Authentication/docs/Set-MgEnvironment.md
@@ -13,8 +13,8 @@ Sets a Microsoft Graph environment to the settings file.
## SYNTAX
```
-Set-MgEnvironment [-Name] [[-AzureADEndpoint] ] [[-GraphEndpoint] ] [-WhatIf]
- [-Confirm] []
+Set-MgEnvironment [-Name] [[-AzureADEndpoint] ] [[-GraphEndpoint] ]
+ [-ProgressAction ] [-WhatIf] [-Confirm] []
```
## DESCRIPTION
@@ -76,6 +76,21 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -Confirm
Prompts you for confirmation before running the cmdlet.
diff --git a/src/Authentication/docs/Set-MgGraphOption.md b/src/Authentication/docs/Set-MgGraphOption.md
index 32abbbdb8c..b519e5fa54 100644
--- a/src/Authentication/docs/Set-MgGraphOption.md
+++ b/src/Authentication/docs/Set-MgGraphOption.md
@@ -28,6 +28,14 @@ PS C:\> Set-MgGraphOption -DisableLoginByWAM $True
Disables sign in via Web Account Manager (WAM). Note: This only takes effect when using a custom ClientId. When using the default ClientId, WAM remains enabled regardless of this setting.
+### Example 2: Disable WAM for sovereign cloud environments
+```powershell
+PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
+```
+
+If WAM broker-based authentication hangs or times out when connecting to a sovereign cloud environment (such as BleuCloud, DelosCloud, or GovSGCloud), disable WAM to fall back to interactive browser sign-in. This can occur when authenticating from environments like jumpboxes. The setting persists across PowerShell sessions.
+
## PARAMETERS
### -DisableLoginByWAM
@@ -46,7 +54,7 @@ Accept wildcard characters: False
```
### -ProgressAction
-{{ Fill ProgressAction Description }}
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
```yaml
Type: ActionPreference
diff --git a/src/Authentication/docs/Set-MgRequestContext.md b/src/Authentication/docs/Set-MgRequestContext.md
index afd36ba276..09506679ed 100644
--- a/src/Authentication/docs/Set-MgRequestContext.md
+++ b/src/Authentication/docs/Set-MgRequestContext.md
@@ -14,7 +14,7 @@ Sets request context for Microsoft Graph invocations
```
Set-MgRequestContext [-RetryDelay ] [-MaxRetry ] [-RetriesTimeLimit ]
- [-ClientTimeout ] [-WhatIf] [-Confirm] []
+ [-ClientTimeout ] [-ProgressAction ] [-WhatIf] [-Confirm] []
```
## DESCRIPTION
@@ -95,6 +95,21 @@ Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
```
+### -ProgressAction
+Determines how PowerShell responds to progress updates generated by this cmdlet. This is a common parameter introduced in PowerShell 7.4.
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
### -RetriesTimeLimit
Sets the maximum time in seconds allowed for request retries.
@@ -163,11 +178,9 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
## INPUTS
### System.Int32
-
## OUTPUTS
### Microsoft.Graph.PowerShell.Authentication.Core.Interfaces.IRequestContext
-
## NOTES
## RELATED LINKS
diff --git a/src/Authentication/examples/Connect-MgGraph.md b/src/Authentication/examples/Connect-MgGraph.md
index edc1c93101..bd135a8467 100644
--- a/src/Authentication/examples/Connect-MgGraph.md
+++ b/src/Authentication/examples/Connect-MgGraph.md
@@ -96,3 +96,10 @@ If the authentication popup hangs or times out when connecting to a sovereign cl
PS C:\> Connect-MgGraph -ContextScope Process
```
To connect as a different identity other than CurrentUser, specify the -ContextScope parameter with the value Process.
+
+### Example 15: Delegated access: Pre-populating the account during interactive sign-in
+```powershell
+PS C:\> Connect-MgGraph -Scopes "User.Read.All" -LoginHint "user@contoso.com"
+```
+Use the -LoginHint parameter to pre-populate the account (login_hint) shown in the interactive browser sign-in prompt.
+On Windows, WAM may still display the account picker on the first sign-in for an account; later sign-ins with the same -LoginHint are silent.
diff --git a/tools/Compare-WrapperCmdletNames.ps1 b/tools/Compare-WrapperCmdletNames.ps1
new file mode 100644
index 0000000000..418790973d
--- /dev/null
+++ b/tools/Compare-WrapperCmdletNames.ps1
@@ -0,0 +1,242 @@
+<#
+.SYNOPSIS
+Parity gate for kiota's PowerShellWrapper generator.
+
+.DESCRIPTION
+See the kiota repo: src/Kiota.Builder/PowerShellWrapper/README.md, sections 4 and 6.
+
+For every generated *.g.cs cmdlet file, reconstructs the HTTP method and URI from the
+client..Async( call chain (CmdletEmitter.cs's templates; the
+chain shape comes from CmdletNaming.BuildBuilderExpression), joins it against the
+Method+Uri -> Command inventory in MgCommandMetadata.json, and reports whether the
+emitted [Cmdlet(...)] name matches what the oracle says the published SDK calls that
+operation.
+
+Dispatcher cmdlets (the paired-GET public cmdlet that only forwards to its internal
+_List/_Get siblings via InvokeCommand.InvokeScript - see CmdletEmitter.EmitGetDispatcher)
+contain no direct Graph call, so there is nothing to reconstruct from their source; they
+are reported separately per module and excluded from the match ratio. Their two internal
+siblings do carry real calls and are what actually gets checked against the oracle.
+
+Path parameter names are not exactly recoverable from the generated C#: CmdletNaming
+.ExtractPathParamNames PascalCases each hyphen-chunk of a raw "{some-id}" segment and
+concatenates with no separator kept, so e.g. "conditionalAccessPolicy-id" and a
+hypothetical "conditionalAccess-policy-id" would both produce the indexer name
+"ConditionalAccessPolicyId" - the hyphen position inside a multi-word param name is lost.
+Fixed path segments do not have this problem (BuildBuilderExpression only ever uppercases
+the first character of a whole segment, which is exactly reversible). So this script
+compares fixed segments exactly and normalizes every path parameter, on both the
+generated and the oracle side, to a single "{param}" placeholder before joining.
+
+The oracle carries both v1.0 and beta rows, and many operations have the identical
+Method+URI in both (only the Command prefix differs: Get-MgUserMessage vs
+Get-MgBetaUserMessage) - joining on Method+URI alone is ambiguous. Each module's
+kiota-lock.json (written next to its *.g.cs files) records the descriptionLocation the
+module was generated from, e.g. "../../openApiDocs/v1.0/Mail.yml"; this script reads the
+v1.0/beta segment out of that path and scopes the oracle lookup to just that ApiVersion.
+A module folder with no kiota-lock.json (or an unrecognized descriptionLocation) falls
+back to searching every ApiVersion and reports a real ambiguity if more than one distinct
+command turns up.
+
+.PARAMETER GeneratedPath
+A folder of generated *.g.cs files for one module, or a folder containing one
+subfolder per module (each with its own *.g.cs files) - e.g. the repo's generated/.
+
+.PARAMETER OraclePath
+Path to MgCommandMetadata.json.
+
+.EXAMPLE
+.\tools\Compare-WrapperCmdletNames.ps1
+.\tools\Compare-WrapperCmdletNames.ps1 -GeneratedPath generated\Mail
+#>
+[CmdletBinding()]
+param(
+ [string]$GeneratedPath = (Join-Path $PSScriptRoot '..\generated'),
+ [string]$OraclePath = (Join-Path $PSScriptRoot '..\src\Authentication\Authentication\custom\common\MgCommandMetadata.json')
+)
+
+$ErrorActionPreference = 'Stop'
+
+if (-not (Test-Path $GeneratedPath)) {
+ Write-Error "Generated path not found: $GeneratedPath"
+ exit 1
+}
+if (-not (Test-Path $OraclePath)) {
+ Write-Error "Oracle file not found: $OraclePath"
+ exit 1
+}
+
+# One folder full of *.g.cs directly, or one folder per module. Handles both so the script
+# works whether -GeneratedPath points at generated/ or at generated/Mail directly.
+function Get-WrapperModuleFolders {
+ param([string]$Root)
+
+ $rootItem = Get-Item -Path $Root
+ $direct = Get-ChildItem -Path $rootItem.FullName -Filter '*.g.cs' -File -ErrorAction SilentlyContinue
+ if ($direct) {
+ return @([pscustomobject]@{ Name = $rootItem.Name; Path = $rootItem.FullName })
+ }
+
+ Get-ChildItem -Path $rootItem.FullName -Directory -ErrorAction SilentlyContinue | ForEach-Object {
+ if (Get-ChildItem -Path $_.FullName -Filter '*.g.cs' -File -ErrorAction SilentlyContinue) {
+ [pscustomobject]@{ Name = $_.Name; Path = $_.FullName }
+ }
+ }
+}
+
+function ConvertTo-NormalizedOracleUri {
+ param([string]$Uri)
+ $parts = $Uri.Trim('/') -split '/'
+ $norm = foreach ($p in $parts) {
+ if ($p -match '^\{.*\}$') { '{param}' } else { $p }
+ }
+ '/' + ($norm -join '/')
+}
+
+function ConvertTo-NormalizedGeneratedUri {
+ param([string]$BuilderExpression)
+ $segments = @()
+ foreach ($token in ($BuilderExpression -split '\.')) {
+ if ($token -notmatch '^([A-Za-z0-9]+)(\[([A-Za-z0-9]+)\])?$') {
+ return $null
+ }
+ $prop = $Matches[1]
+ $segments += ($prop.Substring(0, 1).ToLowerInvariant() + $prop.Substring(1))
+ if ($Matches[3]) { $segments += '{param}' }
+ }
+ '/' + ($segments -join '/')
+}
+
+# Reads the v1.0/beta segment out of a module's kiota-lock.json ("descriptionLocation":
+# "../../openApiDocs/v1.0/Mail.yml"), so the oracle join can be scoped to the ApiVersion
+# the module was actually generated from instead of guessing.
+function Get-ModuleApiVersion {
+ param([string]$ModulePath)
+ $lockPath = Join-Path $ModulePath 'kiota-lock.json'
+ if (-not (Test-Path $lockPath)) { return $null }
+ $loc = (Get-Content -Path $lockPath -Raw | ConvertFrom-Json).descriptionLocation
+ if (-not $loc) { return $null }
+ if ($loc -match '(^|[\\/])v1\.0([\\/]|$)') { return 'v1.0' }
+ if ($loc -match '(^|[\\/])beta([\\/]|$)') { return 'beta' }
+ return $null
+}
+
+Write-Host "Loading oracle from $OraclePath ..."
+$oracle = Get-Content -Path $OraclePath -Raw | ConvertFrom-Json
+
+$oracleIndex = @{}
+foreach ($entry in $oracle) {
+ if (-not $entry.Method -or -not $entry.Uri -or -not $entry.Command -or -not $entry.ApiVersion) { continue }
+ $key = "$($entry.ApiVersion)|$($entry.Method)|$(ConvertTo-NormalizedOracleUri $entry.Uri)"
+ if (-not $oracleIndex.ContainsKey($key)) {
+ $oracleIndex[$key] = [System.Collections.Generic.HashSet[string]]::new()
+ }
+ [void]$oracleIndex[$key].Add($entry.Command)
+}
+Write-Host "Indexed $($oracle.Count) oracle entries into $($oracleIndex.Count) ApiVersion+Method+URI keys."
+Write-Host ''
+
+# Looks up one Method+URI, scoped to $ApiVersion when known; falls back to searching every
+# ApiVersion (and merging what turns up) when the module's own version couldn't be
+# determined, so an unresolvable version shows up as a real ambiguity, not a false match.
+function Find-OracleCommands {
+ param([hashtable]$Index, [string]$ApiVersion, [string]$Method, [string]$NormalizedUri)
+ if ($ApiVersion) {
+ return $Index["$ApiVersion|$Method|$NormalizedUri"]
+ }
+ $merged = [System.Collections.Generic.HashSet[string]]::new()
+ foreach ($v in 'v1.0', 'beta') {
+ $found = $Index["$v|$Method|$NormalizedUri"]
+ if ($found) { [void]$merged.UnionWith($found) }
+ }
+ if ($merged.Count -eq 0) { return $null }
+ return $merged
+}
+
+$cmdletAttrPattern = '\[Cmdlet\(Verbs\w+\.(\w+),\s*"([^"]+)"'
+$callChainPattern = 'client\.([A-Za-z0-9_.\[\]]+)\.(Get|Post|Patch|Put|Delete)Async\('
+
+$modules = @(Get-WrapperModuleFolders -Root $GeneratedPath)
+if ($modules.Count -eq 0) {
+ Write-Error "No *.g.cs files found under $GeneratedPath"
+ exit 1
+}
+
+$totalJoinable = 0
+$totalMatched = 0
+$totalMismatches = 0
+$totalDispatchers = 0
+
+foreach ($module in $modules | Sort-Object Name) {
+ $files = Get-ChildItem -Path $module.Path -Filter '*.g.cs' -File | Sort-Object Name
+ $apiVersion = Get-ModuleApiVersion -ModulePath $module.Path
+ $moduleJoinable = 0
+ $moduleMatched = 0
+ $moduleDispatchers = 0
+ $moduleProblems = @()
+
+ foreach ($file in $files) {
+ $content = Get-Content -Path $file.FullName -Raw
+
+ $attrMatch = [regex]::Match($content, $cmdletAttrPattern)
+ if (-not $attrMatch.Success) {
+ continue # not a cmdlet file (Shared.g.cs)
+ }
+ $verb = $attrMatch.Groups[1].Value
+ $generatedNoun = $attrMatch.Groups[2].Value
+ $publishedNoun = $generatedNoun -replace '_(List|Get)$', ''
+ $generatedCommand = "$verb-$generatedNoun"
+ $expectedCommand = "$verb-$publishedNoun"
+
+ $callMatch = [regex]::Match($content, $callChainPattern)
+ if (-not $callMatch.Success) {
+ $moduleDispatchers++
+ continue # dispatcher: delegates to internal cmdlets, nothing to reconstruct here
+ }
+
+ $builderExpr = $callMatch.Groups[1].Value
+ $method = $callMatch.Groups[2].Value.ToUpperInvariant()
+ $normalizedUri = ConvertTo-NormalizedGeneratedUri -BuilderExpression $builderExpr
+
+ $moduleJoinable++
+
+ if (-not $normalizedUri) {
+ $moduleProblems += " [UNPARSEABLE] $($file.Name): builder expression '$builderExpr' has a segment this script doesn't recognize (e.g. an OData cast segment - see README section 7, cast endpoints aren't generated yet)."
+ continue
+ }
+
+ $candidates = Find-OracleCommands -Index $oracleIndex -ApiVersion $apiVersion -Method $method -NormalizedUri $normalizedUri
+
+ if (-not $candidates -or $candidates.Count -eq 0) {
+ $moduleProblems += " [NO ORACLE ENTRY] $($file.Name): '$generatedCommand' -> reconstructed $method $normalizedUri, no oracle row for that Method+URI."
+ }
+ elseif ($candidates.Count -gt 1) {
+ $moduleProblems += " [AMBIGUOUS] $($file.Name): $method $normalizedUri matches multiple oracle commands: $($candidates -join ', ')."
+ }
+ elseif ($candidates.Contains($expectedCommand)) {
+ $moduleMatched++
+ }
+ else {
+ $moduleProblems += " [MISMATCH] $($file.Name): generated '$expectedCommand', oracle says '$($candidates | Select-Object -First 1)' for $method $normalizedUri."
+ }
+ }
+
+ $status = if ($moduleJoinable -eq 0) { 'n/a' } else { "$moduleMatched of $moduleJoinable" }
+ $dispatcherNote = if ($moduleDispatchers -gt 0) { " (+$moduleDispatchers dispatcher cmdlet(s), no direct call to verify)" } else { '' }
+ $versionNote = if ($apiVersion) { " [$apiVersion]" } else { ' [ApiVersion unknown - searched all versions]' }
+ Write-Host "$($module.Name)$($versionNote): $status cmdlets match the oracle$dispatcherNote"
+ foreach ($line in $moduleProblems) { Write-Host $line -ForegroundColor Yellow }
+
+ $totalJoinable += $moduleJoinable
+ $totalMatched += $moduleMatched
+ $totalMismatches += $moduleProblems.Count
+ $totalDispatchers += $moduleDispatchers
+}
+
+Write-Host ''
+Write-Host "TOTAL: $totalMatched of $totalJoinable cmdlets match the oracle across $($modules.Count) module(s) (+$totalDispatchers dispatcher cmdlet(s) skipped)."
+
+if ($totalMismatches -gt 0) {
+ exit 1
+}
+exit 0
diff --git a/tools/WrapperGenerator.Tests/EmitterTests.cs b/tools/WrapperGenerator.Tests/EmitterTests.cs
new file mode 100644
index 0000000000..a6b9b86aff
--- /dev/null
+++ b/tools/WrapperGenerator.Tests/EmitterTests.cs
@@ -0,0 +1,33 @@
+using System.Collections.Generic;
+using WrapperGenerator;
+using Xunit;
+
+namespace WrapperGenerator.Tests;
+
+public sealed class EmitterTests
+{
+ // A spec-derived noun or header name containing a double quote must be escaped where it is
+ // interpolated into a generated C# string literal, or the generated source will not compile.
+ [Fact]
+ public void EscapesQuotesInSpecDerivedStringLiterals()
+ {
+ var naming = new CmdletNaming(
+ VerbsClass: "VerbsCommon",
+ VerbName: "Remove",
+ Noun: "MgHe\"llo", // quote lands in the [Cmdlet(..., "...")] literal
+ ClassName: "RemoveMgHelloCommand", // class name is a separate, valid identifier
+ PathParamNames: new[] { "UserId" },
+ BuilderExpression: "Users[UserId]",
+ HeaderParams: new[] { new HeaderParam("If\"Match", "IfMatch") }); // quote in a header name
+
+ var source = CmdletEmitter.EmitRemove(naming, new EmitContext("Test.Client"));
+
+ // Escaped forms present (valid literals).
+ Assert.Contains("\"MgHe\\\"llo\"", source); // "MgHe\"llo"
+ Assert.Contains("\"If\\\"Match\"", source); // "If\"Match"
+
+ // Broken/unescaped forms absent.
+ Assert.DoesNotContain("\"MgHe\"llo\"", source); // "MgHe"llo"
+ Assert.DoesNotContain("\"If\"Match\"", source); // "If"Match"
+ }
+}
diff --git a/tools/WrapperGenerator.Tests/GenerationServiceRegressionTests.cs b/tools/WrapperGenerator.Tests/GenerationServiceRegressionTests.cs
new file mode 100644
index 0000000000..271049ab62
--- /dev/null
+++ b/tools/WrapperGenerator.Tests/GenerationServiceRegressionTests.cs
@@ -0,0 +1,149 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging.Abstractions;
+using Microsoft.OpenApi;
+using WrapperGenerator;
+using Xunit;
+
+namespace WrapperGenerator.Tests;
+
+public sealed class GenerationServiceRegressionTests
+{
+ [Fact]
+ public async Task GenerateAsync_SkipsGetWithoutJsonSuccessSchema_DoesNotThrow()
+ {
+ var operation = new OpenApiOperation
+ {
+ OperationId = "user_get_plain_text",
+ Responses = new OpenApiResponses
+ {
+ ["200"] = new OpenApiResponse
+ {
+ Content = new Dictionary
+ {
+ ["text/plain"] = new OpenApiMediaType
+ {
+ Schema = new OpenApiSchema { Type = JsonSchemaType.String },
+ },
+ },
+ },
+ },
+ };
+
+ var document = BuildDocument(HttpMethod.Get, "/users/{user-id}", operation);
+ var files = await RunGeneratorAndListFilesAsync(document);
+
+ Assert.Contains("Shared.g.cs", files);
+ Assert.DoesNotContain(files, f => f != "Shared.g.cs");
+ }
+
+ [Fact]
+ public async Task GenerateAsync_SkipsUnsupportedHttpMethod_DoesNotThrow()
+ {
+ var operation = new OpenApiOperation
+ {
+ OperationId = "user_set_photo_value",
+ RequestBody = new OpenApiRequestBody
+ {
+ Content = new Dictionary
+ {
+ ["application/json"] = new OpenApiMediaType
+ {
+ Schema = new OpenApiSchema
+ {
+ Type = JsonSchemaType.Object,
+ Properties = new Dictionary
+ {
+ ["displayName"] = new OpenApiSchema { Type = JsonSchemaType.String },
+ },
+ },
+ },
+ },
+ },
+ };
+
+ var document = BuildDocument(HttpMethod.Put, "/users/{user-id}/photo/$value", operation);
+ var files = await RunGeneratorAndListFilesAsync(document);
+
+ Assert.Contains("Shared.g.cs", files);
+ Assert.DoesNotContain(files, f => f != "Shared.g.cs");
+ }
+
+ [Fact]
+ public async Task GenerateAsync_SkipsPostWithNonRefBodySchema_DoesNotThrow()
+ {
+ var operation = new OpenApiOperation
+ {
+ OperationId = "user_create_inline",
+ RequestBody = new OpenApiRequestBody
+ {
+ Content = new Dictionary
+ {
+ ["application/json"] = new OpenApiMediaType
+ {
+ // Inline object schema (no $ref) previously caused entity-type resolution crashes.
+ Schema = new OpenApiSchema
+ {
+ Type = JsonSchemaType.Object,
+ Properties = new Dictionary
+ {
+ ["displayName"] = new OpenApiSchema { Type = JsonSchemaType.String },
+ },
+ },
+ },
+ },
+ },
+ };
+
+ var document = BuildDocument(HttpMethod.Post, "/users", operation);
+ var files = await RunGeneratorAndListFilesAsync(document);
+
+ Assert.Contains("Shared.g.cs", files);
+ Assert.DoesNotContain(files, f => f != "Shared.g.cs");
+ }
+
+ private static OpenApiDocument BuildDocument(HttpMethod method, string path, OpenApiOperation operation)
+ {
+ return new OpenApiDocument
+ {
+ Paths = new OpenApiPaths
+ {
+ [path] = new OpenApiPathItem
+ {
+ Operations = new Dictionary
+ {
+ [method] = operation,
+ },
+ },
+ },
+ };
+ }
+
+ private static async Task RunGeneratorAndListFilesAsync(OpenApiDocument document)
+ {
+ var outputDir = Path.Combine(Path.GetTempPath(), "wrapper-generator-tests", Guid.NewGuid().ToString("N"));
+ Directory.CreateDirectory(outputDir);
+
+ try
+ {
+ var config = new GeneratorConfig("Microsoft.Graph.PowerShell.Test.Client", outputDir);
+ var service = new PowerShellWrapperGenerationService(document, config, NullLogger.Instance);
+
+ await service.GenerateAsync(CancellationToken.None);
+
+ var files = Directory.GetFiles(outputDir, "*.g.cs", SearchOption.TopDirectoryOnly);
+ for (var i = 0; i < files.Length; i++)
+ files[i] = Path.GetFileName(files[i]);
+ return files;
+ }
+ finally
+ {
+ if (Directory.Exists(outputDir))
+ Directory.Delete(outputDir, recursive: true);
+ }
+ }
+}
diff --git a/tools/WrapperGenerator.Tests/NamingTests.cs b/tools/WrapperGenerator.Tests/NamingTests.cs
new file mode 100644
index 0000000000..6ef40d424f
--- /dev/null
+++ b/tools/WrapperGenerator.Tests/NamingTests.cs
@@ -0,0 +1,188 @@
+using System.Collections.Generic;
+using WrapperGenerator;
+using Xunit;
+
+namespace WrapperGenerator.Tests;
+
+// The expected values are the published Microsoft.Graph cmdlet names, taken from the
+// MgCommandMetadata.json inventory that ships inside Microsoft.Graph.Authentication.
+// Changing one of these is a deliberate break from SDK parity and belongs in the
+// migration guide, not in a quiet test edit.
+public sealed class SingularizerTests
+{
+ [Theory]
+ // ies -> y
+ [InlineData("Policies", "Policy")]
+ [InlineData("Categories", "Category")]
+ // uses -> us (Get-MgDeviceManagementDeviceConfigurationUserStatus)
+ [InlineData("Statuses", "Status")]
+ // sibilant es
+ [InlineData("Businesses", "Business")]
+ [InlineData("Mailboxes", "Mailbox")]
+ [InlineData("Branches", "Branch")]
+ // ss/us/is guard
+ [InlineData("Access", "Access")]
+ [InlineData("Status", "Status")]
+ [InlineData("Analysis", "Analysis")]
+ // plain s
+ [InlineData("Messages", "Message")]
+ [InlineData("Plans", "Plan")]
+ [InlineData("Settings", "Setting")]
+ [InlineData("Licenses", "License")]
+ // irregulars (Get-MgDriveItemChild, Get-MgUserPerson)
+ [InlineData("Children", "Child")]
+ [InlineData("People", "Person")]
+ // invariants (Get-MgUserSettingWindows)
+ [InlineData("Windows", "Windows")]
+ // acronyms are never plural forms
+ [InlineData("OS", "OS")]
+ public void SingularizesWords(string word, string expected)
+ {
+ Assert.Equal(expected, Singularizer.SingularizeWord(word));
+ }
+
+ [Theory]
+ [InlineData("Users", "User")]
+ [InlineData("ManagedDevices", "ManagedDevice")]
+ [InlineData("BookingBusinesses", "BookingBusiness")]
+ [InlineData("ReportSettings", "ReportSetting")]
+ [InlineData("ConditionalAccess", "ConditionalAccess")]
+ // per-word inflection, matching the published SDK's inflector:
+ // Update-MgDeviceManagementTermAndCondition
+ [InlineData("TermsAndConditions", "TermAndCondition")]
+ // Get-MgDirectoryOnPremiseSynchronization (interior word singularized)
+ [InlineData("OnPremisesSynchronization", "OnPremiseSynchronization")]
+ // version tag: Get-MgSecurityAlertV2
+ [InlineData("Alerts_v2", "AlertV2")]
+ public void SingularizesSegments(string segment, string expected)
+ {
+ Assert.Equal(expected, Singularizer.SingularizeSegment(segment));
+ }
+}
+
+public sealed class NamingTests
+{
+ private static CmdletNaming Resolve(string method, string path)
+ {
+ var pathParams = new List();
+ foreach (var segment in path.Split('/'))
+ {
+ if (segment.StartsWith('{') && segment.EndsWith('}'))
+ pathParams.Add(segment[1..^1]);
+ }
+ return Naming.Resolve(new OperationInfo(method, path, "test_op", pathParams, [], HasBody: false));
+ }
+
+ [Theory]
+ // pilot module goldens (Microsoft.Graph.* 2.37.0 names)
+ [InlineData("GET", "/users", "Get", "MgUser")]
+ [InlineData("GET", "/users/{user-id}", "Get", "MgUser")]
+ [InlineData("POST", "/users", "New", "MgUser")]
+ [InlineData("PATCH", "/users/{user-id}", "Update", "MgUser")]
+ [InlineData("DELETE", "/users/{user-id}", "Remove", "MgUser")]
+ [InlineData("GET", "/users/{user-id}/messages", "Get", "MgUserMessage")]
+ [InlineData("GET", "/users/{user-id}/messages/{message-id}", "Get", "MgUserMessage")]
+ [InlineData("GET", "/users/{user-id}/contacts", "Get", "MgUserContact")]
+ [InlineData("GET", "/applications/{application-id}", "Get", "MgApplication")]
+ [InlineData("GET", "/deviceManagement/managedDevices", "Get", "MgDeviceManagementManagedDevice")]
+ [InlineData("GET", "/identity/conditionalAccess/policies/{conditionalAccessPolicy-id}", "Get", "MgIdentityConditionalAccessPolicy")]
+ [InlineData("GET", "/planner/plans", "Get", "MgPlannerPlan")]
+ [InlineData("GET", "/security/alerts_v2", "Get", "MgSecurityAlertV2")]
+ [InlineData("PATCH", "/admin/reportSettings", "Update", "MgAdminReportSetting")]
+ [InlineData("GET", "/schemaExtensions", "Get", "MgSchemaExtension")]
+ [InlineData("GET", "/domains/{domain-id}", "Get", "MgDomain")]
+ [InlineData("GET", "/groups/{group-id}", "Get", "MgGroup")]
+ [InlineData("GET", "/teams/{team-id}", "Get", "MgTeam")]
+ // overrides mirroring the SDK's own AutoRest directives (see NamingOverrides)
+ [InlineData("GET", "/solutions/bookingBusinesses/{bookingBusiness-id}", "Get", "MgBookingBusiness")]
+ [InlineData("PATCH", "/solutions/bookingBusinesses/{bookingBusiness-id}", "Update", "MgBookingBusiness")]
+ [InlineData("GET", "/users/{user-id}/calendar", "Get", "MgUserDefaultCalendar")]
+ // boundary word-overlap collapse (Get-MgDomainNameReference)
+ [InlineData("GET", "/domains/{domain-id}/domainNameReferences", "Get", "MgDomainNameReference")]
+ // adjacent-duplicate collapse (Get-MgUserOnenoteSectionGroup... family)
+ [InlineData("GET", "/users/{user-id}/onenote/sectionGroups/{sectionGroup-id}/sectionGroups", "Get", "MgUserOnenoteSectionGroup")]
+ // OData cast segments (Get-MgGroupOwnerAsUser)
+ [InlineData("GET", "/groups/{group-id}/owners/{directoryObject-id}/graph.user", "Get", "MgGroupOwnerAsUser")]
+ public void ResolvesPublishedSdkNames(string method, string path, string expectedVerb, string expectedNoun)
+ {
+ var naming = Resolve(method, path);
+ Assert.Equal(expectedVerb, naming.VerbName);
+ Assert.Equal(expectedNoun, naming.Noun);
+ Assert.Equal($"{expectedVerb}{expectedNoun}Command", naming.ClassName);
+ }
+
+ [Theory]
+ // The builder expression is the Kiota request-builder chain the emitted cmdlet calls
+ // (client..GetAsync()). A property per fixed segment, an indexer per path parameter.
+ [InlineData("/users", "Users")]
+ [InlineData("/users/{user-id}", "Users[UserId]")]
+ [InlineData("/users/{user-id}/messages", "Users[UserId].Messages")]
+ [InlineData("/users/{user-id}/messages/{message-id}", "Users[UserId].Messages[MessageId]")]
+ [InlineData("/deviceManagement/managedDevices", "DeviceManagement.ManagedDevices")]
+ [InlineData("/identity/conditionalAccess/policies/{conditionalAccessPolicy-id}", "Identity.ConditionalAccess.Policies[ConditionalAccessPolicyId]")]
+ // OData cast segments: a dotted segment is one Kiota builder member, not a member access.
+ // Verified against a real Kiota C# client: microsoft.graph.user -> the MicrosoftGraphUser
+ // request-builder property; graph.user (KiotaCompat form) -> GraphUser by the same rule.
+ [InlineData("/groups/{group-id}/owners/{directoryObject-id}/graph.user", "Groups[GroupId].Owners[DirectoryObjectId].GraphUser")]
+ [InlineData("/groups/{group-id}/owners/{directoryObject-id}/microsoft.graph.user", "Groups[GroupId].Owners[DirectoryObjectId].MicrosoftGraphUser")]
+ public void BuildsKiotaBuilderExpression(string path, string expectedExpression)
+ {
+ Assert.Equal(expectedExpression, Resolve("GET", path).BuilderExpression);
+ }
+
+ [Fact]
+ public void SuppressesOperationsThePublishedSdkOmits()
+ {
+ // Calendar.md remove-path-by-operation user_UpdateCalendar: no Update cmdlet ships for
+ // the default-calendar singleton.
+ Assert.True(NamingOverrides.IsSuppressed("PATCH", "/users/{user-id}/calendar"));
+ Assert.False(NamingOverrides.IsSuppressed("GET", "/users/{user-id}/calendar"));
+ Assert.False(NamingOverrides.IsSuppressed("PATCH", "/users/{user-id}/messages/{message-id}"));
+ }
+
+ [Fact]
+ public void ListAndItemGetsShareTheNounSoDispatcherPairingSurvives()
+ {
+ var list = Resolve("GET", "/users/{user-id}/messages");
+ var item = Resolve("GET", "/users/{user-id}/messages/{message-id}");
+ Assert.Equal(list.Noun, item.Noun);
+
+ var internalList = Naming.WithSuffix(list, "_List");
+ Assert.Equal("MgUserMessage_List", internalList.Noun);
+ Assert.Equal("GetMgUserMessage_ListCommand", internalList.ClassName);
+ }
+
+ [Fact]
+ public void CleanListItemPairMerges()
+ {
+ // A list GET and its item GET one id deeper share a noun and fit structurally, so they
+ // merge into the single public Get-MgUserMessage dispatcher.
+ var list = Resolve("GET", "/users/{user-id}/messages");
+ var item = Resolve("GET", "/users/{user-id}/messages/{message-id}");
+ Assert.Equal(list.Noun, item.Noun);
+ Assert.True(Naming.IsListItemPair(list, item));
+ }
+
+ [Fact]
+ public void GetWithNoStructuralPartnerStaysStandalone()
+ {
+ // A list under one resource and an item under a different resource neither share a noun
+ // nor fit structurally, so nothing merges — the list is emitted as a standalone cmdlet.
+ var contactsList = Resolve("GET", "/users/{user-id}/contacts");
+ var messageItem = Resolve("GET", "/users/{user-id}/messages/{message-id}");
+ Assert.NotEqual(contactsList.Noun, messageItem.Noun);
+ Assert.False(Naming.IsListItemPair(contactsList, messageItem));
+ }
+
+ [Fact]
+ public void AmbiguousSameNounDoesNotMerge()
+ {
+ // Self-referential /sites: the collection /sites/{id}/sites and the single /sites/{id}
+ // both resolve to MgSite, but the "item" is the parent, not a child one id deeper, so
+ // the structural check rejects the merge and both stay standalone.
+ var list = Resolve("GET", "/sites/{site-id}/sites");
+ var item = Resolve("GET", "/sites/{site-id}");
+ Assert.Equal(list.Noun, item.Noun);
+ Assert.False(Naming.IsListItemPair(list, item));
+ }
+}
diff --git a/tools/WrapperGenerator.Tests/SchemaPropertiesTests.cs b/tools/WrapperGenerator.Tests/SchemaPropertiesTests.cs
new file mode 100644
index 0000000000..5b1909196d
--- /dev/null
+++ b/tools/WrapperGenerator.Tests/SchemaPropertiesTests.cs
@@ -0,0 +1,96 @@
+using System.Collections.Generic;
+using System.Linq;
+using Microsoft.OpenApi;
+using WrapperGenerator;
+using Xunit;
+
+namespace WrapperGenerator.Tests;
+
+public sealed class SchemaPropertiesTests
+{
+ private static OpenApiSchema Scalar(JsonSchemaType type, bool readOnly = false) =>
+ new() { Type = type, ReadOnly = readOnly };
+
+ [Fact]
+ public void KeepsPrimitivesAndPrimitiveArrays_ExcludesServerManagedAndComplex()
+ {
+ var body = new OpenApiSchema
+ {
+ Type = JsonSchemaType.Object,
+ Properties = new Dictionary
+ {
+ // kept
+ ["displayName"] = Scalar(JsonSchemaType.String),
+ ["accountEnabled"] = Scalar(JsonSchemaType.Boolean),
+ ["jobTitle"] = Scalar(JsonSchemaType.Integer),
+ ["businessPhones"] = new OpenApiSchema { Type = JsonSchemaType.Array, Items = Scalar(JsonSchemaType.String) },
+ // excluded
+ ["id"] = Scalar(JsonSchemaType.String), // server-assigned
+ ["@odata.type"] = Scalar(JsonSchemaType.String), // @-prefixed OData control
+ ["createdDateTime"] = Scalar(JsonSchemaType.String, readOnly: true), // ReadOnly
+ ["assignedLicenses"] = new OpenApiSchema // nested complex
+ {
+ Type = JsonSchemaType.Object,
+ Properties = new Dictionary { ["skuId"] = Scalar(JsonSchemaType.String) },
+ },
+ },
+ };
+
+ var names = SchemaProperties.ExtractPrimitiveProperties(body).Select(p => p.OpenApiName).ToHashSet();
+
+ Assert.Contains("displayName", names);
+ Assert.Contains("accountEnabled", names);
+ Assert.Contains("jobTitle", names);
+ Assert.Contains("businessPhones", names);
+
+ Assert.DoesNotContain("id", names);
+ Assert.DoesNotContain("@odata.type", names);
+ Assert.DoesNotContain("createdDateTime", names);
+ Assert.DoesNotContain("assignedLicenses", names);
+ }
+
+ [Fact]
+ public void MapsScalarAndArrayShapes()
+ {
+ var body = new OpenApiSchema
+ {
+ Type = JsonSchemaType.Object,
+ Properties = new Dictionary
+ {
+ ["displayName"] = Scalar(JsonSchemaType.String),
+ ["businessPhones"] = new OpenApiSchema { Type = JsonSchemaType.Array, Items = Scalar(JsonSchemaType.String) },
+ },
+ };
+
+ var props = SchemaProperties.ExtractPrimitiveProperties(body);
+
+ var scalar = props.Single(p => p.OpenApiName == "displayName");
+ Assert.False(scalar.IsArray);
+ Assert.Equal("string", scalar.PsTypeName);
+ Assert.Equal("DisplayName", scalar.PascalName);
+
+ var array = props.Single(p => p.OpenApiName == "businessPhones");
+ Assert.True(array.IsArray);
+ Assert.Equal("string[]", array.PsTypeName);
+ Assert.Equal("BusinessPhones", array.PascalName);
+ }
+
+ [Fact]
+ public void HasPasswordProfile_DetectsDirectAndViaAllOf()
+ {
+ var withProfile = new OpenApiSchema
+ {
+ Properties = new Dictionary { ["passwordProfile"] = new OpenApiSchema { Type = JsonSchemaType.Object } },
+ };
+ Assert.True(SchemaProperties.HasPasswordProfile(withProfile));
+
+ var viaAllOf = new OpenApiSchema { AllOf = new List { withProfile } };
+ Assert.True(SchemaProperties.HasPasswordProfile(viaAllOf));
+
+ var without = new OpenApiSchema
+ {
+ Properties = new Dictionary { ["displayName"] = Scalar(JsonSchemaType.String) },
+ };
+ Assert.False(SchemaProperties.HasPasswordProfile(without));
+ }
+}
diff --git a/tools/WrapperGenerator.Tests/WrapperGenerator.Tests.csproj b/tools/WrapperGenerator.Tests/WrapperGenerator.Tests.csproj
new file mode 100644
index 0000000000..a3634244bc
--- /dev/null
+++ b/tools/WrapperGenerator.Tests/WrapperGenerator.Tests.csproj
@@ -0,0 +1,26 @@
+
+
+
+ net10.0
+ Exe
+ disable
+ enable
+ false
+
+
+
+
+
+
+
+ runtime; build; native; contentfiles; analyzers; buildtransitive
+ all
+
+
+
+
+
+
+
+
diff --git a/tools/WrapperGenerator/CmdletEmitter.cs b/tools/WrapperGenerator/CmdletEmitter.cs
new file mode 100644
index 0000000000..ae31ed6fdf
--- /dev/null
+++ b/tools/WrapperGenerator/CmdletEmitter.cs
@@ -0,0 +1,686 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace WrapperGenerator;
+
+// Emits the wrapper cmdlet shapes from section 8 of the design spec, one cmdlet class per
+// selected OpenAPI operation: mandatory path-id parameters, an optional -AccessToken with a
+// Connect-MgGraph fallback, a ShouldProcess gate on mutating calls, and the Kiota client's
+// property/indexer chain for the actual request.
+public static class CmdletEmitter
+{
+ // Repeated verbatim in every emitted cmdlet. EmitSharedAuth provides the two helpers this
+ // block depends on: IsParameterBound and StaticBearerTokenAuthenticationProvider.
+ private const string AuthBlock = """
+
+ // ── Choose HttpClient + auth provider ─────────────────────────────
+ HttpClient httpClient;
+ IAuthenticationProvider authProvider;
+
+ if (this.IsParameterBound(nameof(AccessToken)))
+ {
+ httpClient = new HttpClient();
+ authProvider = new StaticBearerTokenAuthenticationProvider(AccessToken!);
+ }
+ else
+ {
+ WriteVerbose("[MgPoC] No -AccessToken supplied, using the active Connect-MgGraph session.");
+ try
+ {
+ httpClient = HttpHelpers.GetGraphHttpClient();
+ }
+ catch (Exception ex)
+ {
+ ThrowTerminatingError(new ErrorRecord(
+ new InvalidOperationException(
+ "No active Graph session. Run Connect-MgGraph first, or supply -AccessToken.", ex),
+ "NoGraphSession",
+ ErrorCategory.AuthenticationError,
+ null));
+ return;
+ }
+ authProvider = new AnonymousAuthenticationProvider();
+ }
+
+ var requestAdapter = new HttpClientRequestAdapter(authProvider, httpClient: httpClient);
+ var client = new ApiClient(requestAdapter);
+ """;
+
+ // Escapes a spec-derived value so it is safe inside a double-quoted C# string literal in the
+ // generated source: backslash first, then double-quote. Applied to values taken from the
+ // OpenAPI document (the cmdlet noun and header names) wherever they land inside "..." — an
+ // unescaped quote or backslash would otherwise produce source that does not compile.
+ private static string EscapeLiteral(string value) =>
+ value.Replace("\\", "\\\\", StringComparison.Ordinal).Replace("\"", "\\\"", StringComparison.Ordinal);
+
+ private static string PathParams(CmdletNaming naming) =>
+ string.Join("\n", naming.PathParamNames.Select((name, i) => $$"""
+ [Parameter(Mandatory = true, Position = {{i}})]
+ public string {{name}} { get; set; } = string.Empty;
+ """));
+
+ private static string TargetId(CmdletNaming naming) =>
+ naming.PathParamNames.Count > 0 ? naming.PathParamNames[^1] : "null";
+
+ // Header parameters declared in the spec (most commonly an "If-Match" ETag on PATCH/DELETE)
+ // become real cmdlet parameters. Graph sometimes requires them even when the spec marks
+ // them optional; Planner's PATCH/DELETE is the known example. Dropping them would make
+ // those endpoints impossible to call.
+ private static string HeaderParamDecls(CmdletNaming naming) => HeaderParamDeclsFor(naming.HeaderParams, parameterSetName: null);
+
+ private static string HeaderParamDeclsFor(IReadOnlyList headers, string? parameterSetName)
+ {
+ var setAttr = parameterSetName is null ? "" : $", ParameterSetName = \"{parameterSetName}\"";
+ return string.Join("", headers.Select(h => $$"""
+
+
+ [Parameter(Mandatory = false{{setAttr}},
+ HelpMessage = "Sets the '{{EscapeLiteral(h.RawName)}}' request header (for example an ETag for optimistic concurrency; some Graph APIs require it even where the spec marks it optional).")]
+ public string? {{h.PsName}} { get; set; }
+ """));
+ }
+
+ private static string HeaderBindings(CmdletNaming naming) => HeaderBindingsFor(naming.HeaderParams, extraIndent: "");
+
+ // extraIndent shifts the lines 4 spaces deeper for call sites inside nested if/else blocks.
+ private static string HeaderBindingsFor(IReadOnlyList headers, string extraIndent) =>
+ string.Join("", headers.Select(h => $$"""
+
+
+ {{extraIndent}}if (this.IsParameterBound(nameof({{h.PsName}})))
+ {{extraIndent}} requestConfiguration.Headers.Add("{{EscapeLiteral(h.RawName)}}", {{h.PsName}}!);
+ """));
+
+ // Splits a paired list/item GET's header parameters into: declared on both operations (bind
+ // regardless of which parameter set is active), list-only, and get-only.
+ private static (IReadOnlyList Shared, IReadOnlyList ListOnly, IReadOnlyList GetOnly) PartitionHeaderParams(
+ CmdletNaming listNaming, CmdletNaming itemNaming)
+ {
+ var listNames = listNaming.HeaderParams.Select(h => h.RawName).ToHashSet(StringComparer.OrdinalIgnoreCase);
+ var itemNames = itemNaming.HeaderParams.Select(h => h.RawName).ToHashSet(StringComparer.OrdinalIgnoreCase);
+ var shared = listNaming.HeaderParams.Where(h => itemNames.Contains(h.RawName)).ToList();
+ var listOnly = listNaming.HeaderParams.Where(h => !itemNames.Contains(h.RawName)).ToList();
+ var getOnly = itemNaming.HeaderParams.Where(h => !listNames.Contains(h.RawName)).ToList();
+ return (shared, listOnly, getOnly);
+ }
+
+ // Every emitted cmdlet accepts -AccessToken as an alternative to an active Connect-MgGraph
+ // session. See AuthBlock.
+ private static string AccessTokenParamDecl() => """
+ [Parameter(Mandatory = false,
+ HelpMessage = "Bearer access token. Omit if you have already run Connect-MgGraph.")]
+ public string? AccessToken { get; set; }
+""";
+
+ // The shared try/catch tail around every Graph call. Only the ErrorRecord's target object
+ // varies, and sometimes the nesting depth (EmitUpdate's re-fetch sits one block deeper).
+ private static string CatchBlock(string targetIdExpr, string extraIndent = "") => $$"""
+ {{extraIndent}}catch (Exception ex)
+ {{extraIndent}}{
+ {{extraIndent}}ThrowTerminatingError(new ErrorRecord(ex, "GraphRequestFailed", ErrorCategory.InvalidOperation, {{targetIdExpr}}));
+ {{extraIndent}}return;
+ {{extraIndent}}}
+""";
+
+ // The -Headers dictionary, matching the published SDK's parameter of the same name. It
+ // lets a caller set any header, not just the ones the spec declares.
+ private static string GenericHeadersParamDecl() => $$"""
+
+
+ [Parameter(Mandatory = false,
+ HelpMessage = "Additional HTTP request headers to send, keyed by header name.")]
+ public System.Collections.IDictionary? Headers { get; set; }
+ """;
+
+ private static string GenericHeadersBinding(string extraIndent = "") => $$"""
+
+
+ {{extraIndent}}if (this.IsParameterBound(nameof(Headers)))
+ {{extraIndent}}{
+ {{extraIndent}} foreach (System.Collections.DictionaryEntry entry in Headers!)
+ {{extraIndent}} requestConfiguration.Headers.Add(entry.Key.ToString()!, entry.Value?.ToString() ?? string.Empty);
+ {{extraIndent}}}
+ """;
+
+ // Post/Patch/DeleteAsync always take a requestConfiguration lambda, because -Headers exists
+ // on every cmdlet. Reuses the same binding fragments the GET emitters use, at this call
+ // site's deeper indent, so there is one binding implementation instead of three.
+ private static string EmitCallWithOptionalHeaders(CmdletNaming naming, string method, string? bodyArg)
+ {
+ var call = $"client.{naming.BuilderExpression}.{method}(";
+ var args = bodyArg is null ? "" : bodyArg + ", ";
+ var bindings = HeaderBindingsFor(naming.HeaderParams, extraIndent: " ") + GenericHeadersBinding(" ");
+ return $"{call}{args}requestConfiguration =>\n {{{bindings}\n }})";
+ }
+
+ public static string EmitItemGet(CmdletNaming naming, EmitContext ctx, string entityType)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ return $$"""
+#nullable enable
+
+using System;
+using System.Management.Automation;
+using System.Net.Http;
+using Microsoft.Graph.PowerShell.Authentication.Helpers;
+using {{ctx.ClientNamespace}};
+using {{ctx.ModelsNamespace}};
+using Microsoft.Kiota.Abstractions;
+using Microsoft.Kiota.Abstractions.Authentication;
+using Microsoft.Kiota.Http.HttpClientLibrary;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsCommon.{{naming.VerbName}}, "{{EscapeLiteral(naming.Noun)}}")]
+ [OutputType(typeof({{entityType}}))]
+ public class {{naming.ClassName}} : PSCmdlet
+ {
+{{PathParams(naming)}}
+
+{{AccessTokenParamDecl()}}
+
+ [Parameter(Mandatory = false)]
+ [Alias("Select")]
+ public string[]? Property { get; set; }
+
+ [Parameter(Mandatory = false)]
+ [Alias("Expand")]
+ public string[]? ExpandProperty { get; set; }
+{{HeaderParamDecls(naming)}}
+{{GenericHeadersParamDecl()}}
+
+ protected override void ProcessRecord()
+ {
+{{AuthBlock}}
+
+ {{entityType}} result;
+ try
+ {
+ result = client.{{naming.BuilderExpression}}.GetAsync(requestConfiguration =>
+ {
+ if (this.IsParameterBound(nameof(Property)))
+ requestConfiguration.QueryParameters.Select = Property;
+
+ if (this.IsParameterBound(nameof(ExpandProperty)))
+ requestConfiguration.QueryParameters.Expand = ExpandProperty;
+{{HeaderBindings(naming)}}
+{{GenericHeadersBinding()}}
+ }).GetAwaiter().GetResult();
+ }
+{{CatchBlock(TargetId(naming))}}
+
+ WriteObject(result);
+ }
+ }
+}
+
+""";
+ }
+
+ // Collection GETs do not all support the same OData query options (GET /users has no $skip,
+ // for example), so the emitted parameters follow what the operation declares, not a fixed
+ // set. Primary names match the published SDK (Property, ExpandProperty, Sort); the
+ // wrapper's original names stay as aliases so -Select/-Expand/-OrderBy keep working.
+ //
+ // ParamDecl takes the owning parameter-set name (null when the cmdlet has no sets) so the
+ // dispatcher can derive its "List"-tagged declarations from this same table instead of
+ // keeping a second copy that would drift.
+ private static string ParamSetDecl(string? parameterSetName, string propertyDecl, string? alias = null)
+ {
+ var setAttr = parameterSetName is null ? "" : $", ParameterSetName = \"{parameterSetName}\"";
+ var aliasLine = alias is null ? "" : $"\n [Alias(\"{alias}\")]";
+ return $" [Parameter(Mandatory = false{setAttr})]{aliasLine}\n {propertyDecl}";
+ }
+
+ private static readonly (string ODataName, string PsName, Func ParamDecl, string Binding)[] CollectionQueryOptions =
+ [
+ ("$filter", "Filter", ps => ParamSetDecl(ps, "public string? Filter { get; set; }"),
+ " if (this.IsParameterBound(nameof(Filter)))\n requestConfiguration.QueryParameters.Filter = Filter;"),
+ ("$select", "Property", ps => ParamSetDecl(ps, "public string[]? Property { get; set; }", alias: "Select"),
+ " if (this.IsParameterBound(nameof(Property)))\n requestConfiguration.QueryParameters.Select = Property;"),
+ ("$expand", "ExpandProperty", ps => ParamSetDecl(ps, "public string[]? ExpandProperty { get; set; }", alias: "Expand"),
+ " if (this.IsParameterBound(nameof(ExpandProperty)))\n requestConfiguration.QueryParameters.Expand = ExpandProperty;"),
+ ("$orderby", "Sort", ps => ParamSetDecl(ps, "public string[]? Sort { get; set; }", alias: "OrderBy"),
+ " if (this.IsParameterBound(nameof(Sort)))\n requestConfiguration.QueryParameters.Orderby = Sort;"),
+ ("$search", "Search", ps => ParamSetDecl(ps, "public string? Search { get; set; }"),
+ " if (this.IsParameterBound(nameof(Search)))\n requestConfiguration.QueryParameters.Search = Search;"),
+ ("$top", "Top", ps => ParamSetDecl(ps, "public int Top { get; set; }"),
+ " if (this.IsParameterBound(nameof(Top)))\n requestConfiguration.QueryParameters.Top = Top;"),
+ ("$skip", "Skip", ps => ParamSetDecl(ps, "public int Skip { get; set; }"),
+ " if (this.IsParameterBound(nameof(Skip)))\n requestConfiguration.QueryParameters.Skip = Skip;"),
+ ("$count", "Count", ps => ParamSetDecl(ps, "public SwitchParameter Count { get; set; }"),
+ " if (Count.IsPresent)\n requestConfiguration.QueryParameters.Count = true;"),
+ ];
+
+ public static string EmitListGet(CmdletNaming naming, EmitContext ctx, string entityType, string collectionResponseType, IReadOnlySet queryParamNames)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ ArgumentNullException.ThrowIfNull(queryParamNames);
+ var applicable = CollectionQueryOptions.Where(o => queryParamNames.Contains(o.ODataName)).ToList();
+ var paramDecls = string.Join("\n\n", applicable.Select(o => o.ParamDecl(null)));
+ var bindings = string.Join("\n\n", applicable.Select(o => o.Binding));
+
+ return $$"""
+#nullable enable
+
+using System;
+using System.Management.Automation;
+using System.Net.Http;
+using Microsoft.Graph.PowerShell.Authentication.Helpers;
+using {{ctx.ClientNamespace}};
+using {{ctx.ModelsNamespace}};
+using Microsoft.Kiota.Abstractions;
+using Microsoft.Kiota.Abstractions.Authentication;
+using Microsoft.Kiota.Http.HttpClientLibrary;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsCommon.{{naming.VerbName}}, "{{EscapeLiteral(naming.Noun)}}")]
+ [OutputType(typeof({{entityType}}))]
+ public class {{naming.ClassName}} : PSCmdlet
+ {
+{{PathParams(naming)}}
+
+{{AccessTokenParamDecl()}}
+
+{{paramDecls}}
+{{HeaderParamDecls(naming)}}
+{{GenericHeadersParamDecl()}}
+
+ protected override void ProcessRecord()
+ {
+{{AuthBlock}}
+
+ {{collectionResponseType}} result;
+ try
+ {
+ result = client.{{naming.BuilderExpression}}.GetAsync(requestConfiguration =>
+ {
+{{bindings}}
+{{HeaderBindings(naming)}}
+{{GenericHeadersBinding()}}
+ }).GetAwaiter().GetResult();
+ }
+{{CatchBlock(TargetId(naming))}}
+
+ WriteObject(result.Value, enumerateCollection: true);
+ }
+ }
+}
+
+""";
+ }
+
+ // The dispatcher's list-only parameter declarations: CollectionQueryOptions minus
+ // $select/$expand, which are shared with the "Get" set and declared once at class level.
+ // Declarations only; binding happens in the internal list cmdlet the dispatcher calls.
+ private static IEnumerable<(string ODataName, string ParamDecl)> ListOnlyQueryOptionsForMerge() =>
+ CollectionQueryOptions
+ .Where(o => o.ODataName is not ("$select" or "$expand"))
+ .Select(o => (o.ODataName, o.ParamDecl("List")));
+
+ // Shared path params (-UserId on a nested list) carry no ParameterSetName, which PowerShell
+ // treats as "all sets". The trailing item id (-MessageId) belongs to the "Get" set only and
+ // continues the Position sequence where the shared ones left off.
+ private static string PairedPathParams(IReadOnlyList sharedNames, IReadOnlyList getOnlyNames)
+ {
+ var parts = new List();
+ var sharedDecls = string.Join("\n", sharedNames.Select((name, i) => $$"""
+ [Parameter(Mandatory = true, Position = {{i}})]
+ public string {{name}} { get; set; } = string.Empty;
+ """));
+ if (sharedDecls.Length > 0)
+ parts.Add(sharedDecls);
+
+ var getOnlyDecls = string.Join("\n", getOnlyNames.Select((name, i) => $$"""
+ [Parameter(Mandatory = true, ParameterSetName = "Get", Position = {{sharedNames.Count + i}})]
+ public string {{name}} { get; set; } = string.Empty;
+ """));
+ if (getOnlyDecls.Length > 0)
+ parts.Add(getOnlyDecls);
+
+ return string.Join("\n", parts);
+ }
+
+ // The thin public cmdlet for a paired list/item GET. It presents the merged Get-MgX surface
+ // the published SDK exposes ("List" as the default set, "Get" for item lookups) but makes no
+ // HTTP call itself. Per the design spec's parameter-set decision, the real work stays in the
+ // two internal cmdlets; ProcessRecord only picks one and forwards the bound parameters. The
+ // forward goes through InvokeCommand.InvokeScript on the current runspace, so the nested
+ // call shares the caller's session, including an active Connect-MgGraph.
+ public static string EmitGetDispatcher(CmdletNaming listNaming, CmdletNaming itemNaming,
+ CmdletNaming internalListNaming, CmdletNaming internalItemNaming, EmitContext ctx,
+ string entityType, string collectionResponseType, IReadOnlySet queryParamNames)
+ {
+ ArgumentNullException.ThrowIfNull(listNaming);
+ ArgumentNullException.ThrowIfNull(itemNaming);
+ ArgumentNullException.ThrowIfNull(internalListNaming);
+ ArgumentNullException.ThrowIfNull(internalItemNaming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ ArgumentNullException.ThrowIfNull(queryParamNames);
+
+ var sharedPathParams = listNaming.PathParamNames;
+ var getOnlyPathParams = itemNaming.PathParamNames.Skip(sharedPathParams.Count).ToList();
+
+ var applicable = ListOnlyQueryOptionsForMerge().Where(o => queryParamNames.Contains(o.ODataName)).ToList();
+ var listOnlyParamDecls = string.Join("\n\n", applicable.Select(o => o.ParamDecl));
+
+ var (sharedHeaders, listOnlyHeaders, getOnlyHeaders) = PartitionHeaderParams(listNaming, itemNaming);
+
+ var internalListCmdletName = $"{internalListNaming.VerbName}-{internalListNaming.Noun}";
+ var internalGetCmdletName = $"{internalItemNaming.VerbName}-{internalItemNaming.Noun}";
+
+ return $$"""
+#nullable enable
+
+using System;
+using System.Management.Automation;
+using System.Management.Automation.Runspaces;
+using {{ctx.ModelsNamespace}};
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsCommon.Get, "{{EscapeLiteral(listNaming.Noun)}}", DefaultParameterSetName = "List")]
+ [OutputType(typeof({{collectionResponseType}}), ParameterSetName = new[] { "List" })]
+ [OutputType(typeof({{entityType}}), ParameterSetName = new[] { "Get" })]
+ public class {{listNaming.ClassName}} : PSCmdlet
+ {
+{{PairedPathParams(sharedPathParams, getOnlyPathParams)}}
+
+{{AccessTokenParamDecl()}}
+
+ [Parameter(Mandatory = false)]
+ [Alias("Select")]
+ public string[]? Property { get; set; }
+
+ [Parameter(Mandatory = false)]
+ [Alias("Expand")]
+ public string[]? ExpandProperty { get; set; }
+
+{{listOnlyParamDecls}}
+{{HeaderParamDeclsFor(sharedHeaders, parameterSetName: null)}}
+{{HeaderParamDeclsFor(listOnlyHeaders, parameterSetName: "List")}}
+{{HeaderParamDeclsFor(getOnlyHeaders, parameterSetName: "Get")}}
+{{GenericHeadersParamDecl()}}
+
+ // Delegates to {{internalGetCmdletName}} or {{internalListCmdletName}}, the two cmdlets
+ // that actually call Graph.
+ protected override void ProcessRecord()
+ {
+ var internalCmdletName = ParameterSetName == "Get" ? "{{EscapeLiteral(internalGetCmdletName)}}" : "{{EscapeLiteral(internalListCmdletName)}}";
+ try
+ {
+ InvokeCommand.InvokeScript(
+ "param($BoundParameters, $CmdletName) & $CmdletName @BoundParameters",
+ false,
+ PipelineResultTypes.Output | PipelineResultTypes.Error,
+ null,
+ MyInvocation.BoundParameters, internalCmdletName);
+ }
+{{CatchBlock(TargetId(itemNaming))}}
+ }
+ }
+}
+
+""";
+ }
+
+ public static string EmitNew(CmdletNaming naming, EmitContext ctx, string entityType, IReadOnlyList properties, bool hasPasswordProfile)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ ArgumentNullException.ThrowIfNull(properties);
+ return $$"""
+#nullable enable
+
+using System;
+using System.Linq;
+using System.Management.Automation;
+using System.Net.Http;
+using Microsoft.Graph.PowerShell.Authentication.Helpers;
+using {{ctx.ClientNamespace}};
+using {{ctx.ModelsNamespace}};
+using Microsoft.Kiota.Abstractions.Authentication;
+using Microsoft.Kiota.Http.HttpClientLibrary;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsCommon.{{naming.VerbName}}, "{{EscapeLiteral(naming.Noun)}}", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium)]
+ [OutputType(typeof({{entityType}}))]
+ public class {{naming.ClassName}} : PSCmdlet
+ {
+{{PathParams(naming)}}
+{{EmitPropertyParameters(properties)}}
+{{(hasPasswordProfile ? EmitPasswordProfileParameters() : "")}}
+{{HeaderParamDecls(naming)}}
+{{GenericHeadersParamDecl()}}
+
+{{AccessTokenParamDecl()}}
+
+ protected override void ProcessRecord()
+ {
+ if (!ShouldProcess({{TargetId(naming)}}, "{{naming.VerbName}}"))
+ return;
+
+ var body = new {{entityType}}();
+{{EmitPropertyAssignments(properties)}}
+{{(hasPasswordProfile ? EmitPasswordProfileAssignment() : "")}}
+{{AuthBlock}}
+
+ {{entityType}}? result;
+ try
+ {
+ result = {{EmitCallWithOptionalHeaders(naming, "PostAsync", "body")}}.GetAwaiter().GetResult();
+ }
+{{CatchBlock("body")}}
+
+ WriteObject(result);
+ }
+ }
+}
+
+""";
+ }
+
+ public static string EmitUpdate(CmdletNaming naming, EmitContext ctx, string entityType, IReadOnlyList properties, bool hasPasswordProfile)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ ArgumentNullException.ThrowIfNull(properties);
+ return $$"""
+#nullable enable
+
+using System;
+using System.Linq;
+using System.Management.Automation;
+using System.Net.Http;
+using Microsoft.Graph.PowerShell.Authentication.Helpers;
+using {{ctx.ClientNamespace}};
+using {{ctx.ModelsNamespace}};
+using Microsoft.Kiota.Abstractions.Authentication;
+using Microsoft.Kiota.Http.HttpClientLibrary;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsData.{{naming.VerbName}}, "{{EscapeLiteral(naming.Noun)}}", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium)]
+ [OutputType(typeof({{entityType}}))]
+ public class {{naming.ClassName}} : PSCmdlet
+ {
+{{PathParams(naming)}}
+{{EmitPropertyParameters(properties)}}
+{{(hasPasswordProfile ? EmitPasswordProfileParameters() : "")}}
+{{HeaderParamDecls(naming)}}
+{{GenericHeadersParamDecl()}}
+
+{{AccessTokenParamDecl()}}
+
+ protected override void ProcessRecord()
+ {
+ if (!ShouldProcess({{TargetId(naming)}}, "{{naming.VerbName}}"))
+ return;
+
+ var body = new {{entityType}}();
+{{EmitPropertyAssignments(properties)}}
+{{(hasPasswordProfile ? EmitPasswordProfileAssignment() : "")}}
+{{AuthBlock}}
+
+ {{entityType}}? result;
+ try
+ {
+ result = {{EmitCallWithOptionalHeaders(naming, "PatchAsync", "body")}}.GetAwaiter().GetResult();
+ }
+{{CatchBlock(TargetId(naming))}}
+
+ // Graph often answers a successful PATCH with 204 and no body (seen live on
+ // schemaExtension update). Re-fetch so the cmdlet returns the updated resource
+ // instead of nothing.
+ if (result is null)
+ {
+ WriteVerbose("[MgPoC] PATCH succeeded with no response body, re-fetching the updated resource.");
+ try
+ {
+ result = client.{{naming.BuilderExpression}}.GetAsync().GetAwaiter().GetResult();
+ }
+{{CatchBlock(TargetId(naming), " ")}}
+ }
+
+ WriteObject(result);
+ }
+ }
+}
+
+""";
+ }
+
+ public static string EmitRemove(CmdletNaming naming, EmitContext ctx)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ ArgumentNullException.ThrowIfNull(ctx);
+ return $$"""
+#nullable enable
+
+using System;
+using System.Management.Automation;
+using System.Net.Http;
+using Microsoft.Graph.PowerShell.Authentication.Helpers;
+using {{ctx.ClientNamespace}};
+using Microsoft.Kiota.Abstractions.Authentication;
+using Microsoft.Kiota.Http.HttpClientLibrary;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ [Cmdlet(VerbsCommon.{{naming.VerbName}}, "{{EscapeLiteral(naming.Noun)}}", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.High)]
+ public class {{naming.ClassName}} : PSCmdlet
+ {
+{{PathParams(naming)}}
+{{HeaderParamDecls(naming)}}
+{{GenericHeadersParamDecl()}}
+
+{{AccessTokenParamDecl()}}
+
+ protected override void ProcessRecord()
+ {
+ if (!ShouldProcess({{TargetId(naming)}}, "{{naming.VerbName}}"))
+ return;
+{{AuthBlock}}
+
+ // DeleteAsync returns a plain Task: a standard delete response has no body.
+ try
+ {
+ {{EmitCallWithOptionalHeaders(naming, "DeleteAsync", null)}}
+ .GetAwaiter().GetResult();
+ }
+{{CatchBlock(TargetId(naming))}}
+ }
+ }
+}
+
+""";
+ }
+
+ // Written once per module. Every cmdlet file relies on same-namespace visibility for these
+ // helpers instead of carrying its own copy.
+ public static string EmitSharedAuth(EmitContext ctx)
+ {
+ ArgumentNullException.ThrowIfNull(ctx);
+ return $$"""
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using System.Management.Automation;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Kiota.Abstractions;
+using Microsoft.Kiota.Abstractions.Authentication;
+
+namespace {{ctx.CmdletNamespace}}
+{
+ internal static class CmdletExtensions
+ {
+ public static bool IsParameterBound(this PSCmdlet cmdlet, string parameterName)
+ => cmdlet.MyInvocation?.BoundParameters.ContainsKey(parameterName) ?? false;
+ }
+
+ // Minimal IAuthenticationProvider for the -AccessToken path: just stamps the bearer header
+ // Kiota's own request-adapter pipeline expects, no token acquisition/refresh.
+ internal sealed class StaticBearerTokenAuthenticationProvider : IAuthenticationProvider
+ {
+ private readonly string _token;
+
+ public StaticBearerTokenAuthenticationProvider(string token)
+ {
+ _token = token.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase)
+ ? token.Substring(7)
+ : token;
+ }
+
+ public Task AuthenticateRequestAsync(RequestInformation request, Dictionary? additionalAuthenticationContext = null, CancellationToken cancellationToken = default)
+ {
+ request.Headers.TryAdd("Authorization", $"Bearer {_token}");
+ return Task.CompletedTask;
+ }
+ }
+}
+""";
+ }
+
+ private static string EmitPropertyParameters(IReadOnlyList properties) =>
+ string.Join("\n", properties.Select(p => $$"""
+
+ [Parameter(Mandatory = false)]
+ public {{p.PsTypeName}}? {{p.PascalName}} { get; set; }
+ """));
+
+ private static string EmitPropertyAssignments(IReadOnlyList properties) =>
+ string.Join("\n", properties.Select(p => $$"""
+
+ if (this.IsParameterBound(nameof({{p.PascalName}})))
+ body.{{p.PascalName}} = {{(p.IsArray ? $"{p.PascalName}!.ToList()" : p.PascalName)}};
+ """));
+
+ private static string EmitPasswordProfileParameters() => """
+
+ [Parameter(Mandatory = false,
+ HelpMessage = "Required by Graph to create a user. Ignored if the resource has no passwordProfile.")]
+ public string? Password { get; set; }
+
+ [Parameter(Mandatory = false)]
+ public bool? ForceChangePasswordNextSignIn { get; set; }
+ """;
+
+ private static string EmitPasswordProfileAssignment() => """
+
+ if (this.IsParameterBound(nameof(Password)) || this.IsParameterBound(nameof(ForceChangePasswordNextSignIn)))
+ {
+ body.PasswordProfile = new PasswordProfile
+ {
+ Password = Password,
+ ForceChangePasswordNextSignIn = ForceChangePasswordNextSignIn ?? true,
+ };
+ }
+ """;
+}
diff --git a/tools/WrapperGenerator/CmdletNaming.cs b/tools/WrapperGenerator/CmdletNaming.cs
new file mode 100644
index 0000000000..22c146169f
--- /dev/null
+++ b/tools/WrapperGenerator/CmdletNaming.cs
@@ -0,0 +1,177 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace WrapperGenerator;
+
+public sealed record HeaderParam(string RawName, string PsName);
+
+public sealed record CmdletNaming(
+ string VerbsClass,
+ string VerbName,
+ string Noun,
+ string ClassName,
+ IReadOnlyList PathParamNames,
+ string BuilderExpression,
+ IReadOnlyList HeaderParams);
+
+public static class Naming
+{
+ // GET->Get, POST->New, PATCH->Update, PUT->Set, DELETE->Remove (design spec section 7).
+ // The attribute class is tracked too because it differs per verb: Update lives in
+ // VerbsData, the rest in VerbsCommon.
+ private static readonly Dictionary VerbMap = new(StringComparer.OrdinalIgnoreCase)
+ {
+ ["get"] = ("VerbsCommon", "Get"),
+ ["post"] = ("VerbsCommon", "New"),
+ ["patch"] = ("VerbsData", "Update"),
+ ["put"] = ("VerbsCommon", "Set"),
+ ["delete"] = ("VerbsCommon", "Remove"),
+ };
+
+ public static CmdletNaming Resolve(OperationInfo operation)
+ {
+ ArgumentNullException.ThrowIfNull(operation);
+ if (!VerbMap.TryGetValue(operation.HttpMethod, out var verb))
+ throw new NotSupportedException($"No cmdlet verb mapping for HTTP method '{operation.HttpMethod}'.");
+
+ // The noun comes from the URL path, not the operationId. OperationIds keep whatever
+ // plurality the spec author chose, while the published SDK names follow the path:
+ // GET /users/{id}/messages is Get-MgUserMessage. The few hand-tuned exceptions the
+ // published SDK carries are mirrored as data in NamingOverrides, never as code here.
+ var noun = "Mg" + NamingOverrides.ApplyNounOverrides(operation.HttpMethod, operation.Path, BuildNounFromPath(operation.Path));
+
+ // A list GET (/users/{id}/messages) and its item GET (/users/{id}/messages/{message-id})
+ // get the same noun on purpose. PowerShellWrapperGenerationService pairs them into one
+ // public Get-MgX dispatcher cmdlet; the two real implementations get suffixed names via
+ // WithSuffix below.
+ var className = $"{verb.VerbName}{noun}Command";
+
+ var pathParamNames = ExtractPathParamNames(operation.Path);
+ var builderExpression = BuildBuilderExpression(operation.Path, pathParamNames);
+ var headerParams = (operation.HeaderParams ?? [])
+ .Select(raw => new HeaderParam(raw, raw.ToPascalCase('-')))
+ .ToList();
+
+ return new CmdletNaming(verb.VerbsClass, verb.VerbName, noun, className, pathParamNames, builderExpression, headerParams);
+ }
+
+ // Names one of the two internal cmdlets behind a paired GET dispatcher, e.g.
+ // Get-MgUserMessage_List. The public dispatcher keeps the bare noun.
+ public static CmdletNaming WithSuffix(CmdletNaming naming, string suffix)
+ {
+ ArgumentNullException.ThrowIfNull(naming);
+ return naming with
+ {
+ Noun = naming.Noun + suffix,
+ ClassName = $"{naming.VerbName}{naming.Noun}{suffix}Command",
+ };
+ }
+
+ // Pascal-cases and singularizes every fixed path segment, then joins them. Two kinds of
+ // repetition are dropped, because the published SDK drops them:
+ // /sites/{id}/sites -> Site (not SiteSite)
+ // /domains/{id}/domainNameReferences -> DomainNameReference (the shared word "Domain"
+ // appears once, matching Get-MgDomainNameReference)
+ // An OData cast segment like graph.user becomes AsUser, matching Get-MgGroupOwnerAsUser.
+ // Cast type names are already singular, so they skip the singularizer.
+ private static string BuildNounFromPath(string path)
+ {
+ var parts = new List();
+ foreach (var segment in path.Split('/', StringSplitOptions.RemoveEmptyEntries))
+ {
+ if (segment.StartsWith('{') && segment.EndsWith('}'))
+ continue;
+
+ var castType = segment.StartsWith("microsoft.graph.", StringComparison.OrdinalIgnoreCase)
+ ? segment["microsoft.graph.".Length..]
+ : segment.StartsWith("graph.", StringComparison.OrdinalIgnoreCase)
+ ? segment["graph.".Length..]
+ : null;
+ if (castType is not null)
+ {
+ parts.Add("As" + castType.ToFirstCharacterUpperCase());
+ continue;
+ }
+
+ var part = Singularizer.SingularizeSegment(segment.ToFirstCharacterUpperCase());
+ if (parts.Count > 0)
+ {
+ var previous = parts[^1];
+ if (string.Equals(previous, part, StringComparison.Ordinal))
+ continue;
+ var boundaryWord = Singularizer.TrailingWord(previous);
+ if (string.Equals(part, boundaryWord, StringComparison.Ordinal))
+ continue;
+ if (part.StartsWith(boundaryWord, StringComparison.Ordinal) && part.Length > boundaryWord.Length)
+ part = part[boundaryWord.Length..];
+ }
+ parts.Add(part);
+ }
+ return string.Concat(parts);
+ }
+
+ private static List ExtractPathParamNames(string path)
+ {
+ var names = new List();
+ foreach (var segment in path.Split('/', StringSplitOptions.RemoveEmptyEntries))
+ {
+ if (segment.StartsWith('{') && segment.EndsWith('}'))
+ names.Add(segment[1..^1].ToPascalCase('-'));
+ }
+ return names;
+ }
+
+ // The Kiota-generated ApiClient exposes a property per fixed path segment and an indexer
+ // per path parameter, e.g. client.Users[UserId].Messages[MessageId].
+ private static string BuildBuilderExpression(string path, List pathParamNames)
+ {
+ var expression = new System.Text.StringBuilder();
+ var paramIndex = 0;
+ var first = true;
+
+ foreach (var segment in path.Split('/', StringSplitOptions.RemoveEmptyEntries))
+ {
+ if (segment.StartsWith('{') && segment.EndsWith('}'))
+ {
+ expression.Append('[').Append(pathParamNames[paramIndex++]).Append(']');
+ }
+ else
+ {
+ if (!first)
+ expression.Append('.');
+ expression.Append(ToBuilderMemberName(segment));
+ }
+ first = false;
+ }
+
+ return expression.ToString();
+ }
+
+ // A fixed path segment becomes one Kiota request-builder member. An OData cast segment
+ // carries dots ("microsoft.graph.user", or "graph.user" in the KiotaCompat specs); Kiota
+ // maps it to a single member by upper-casing each dot-separated part and concatenating, so
+ // "microsoft.graph.user" is the "MicrosoftGraphUser" property, "graph.user" is "GraphUser"
+ // (verified against a generated Kiota C# client). Emitting the raw segment would leave a
+ // stray dot ("Graph.user") — invalid C# and not a real builder member. Non-cast segments
+ // have no dots and are unchanged. NOTE: cast endpoints are not generated end to end yet
+ // (tracked follow-up), so this keeps the expression a valid identifier chain until then.
+ private static string ToBuilderMemberName(string segment) =>
+ segment.Contains('.', StringComparison.Ordinal)
+ ? string.Concat(segment.Split('.', StringSplitOptions.RemoveEmptyEntries).Select(part => part.ToFirstCharacterUpperCase()))
+ : segment.ToFirstCharacterUpperCase();
+
+ // Whether a list GET and an item GET form a mergeable pair for the public Get-MgX
+ // dispatcher: the item's path must be the list's path plus exactly one trailing id
+ // (Users[UserId].Messages -> Users[UserId].Messages[MessageId]). Callers group by noun
+ // first, so this only decides the structural fit; a same-noun item that does not extend the
+ // list (for example the self-referential /sites/{id} vs /sites/{id}/sites) is rejected.
+ public static bool IsListItemPair(CmdletNaming list, CmdletNaming item)
+ {
+ ArgumentNullException.ThrowIfNull(list);
+ ArgumentNullException.ThrowIfNull(item);
+ return item.PathParamNames.Count == list.PathParamNames.Count + 1
+ && item.PathParamNames.Take(list.PathParamNames.Count).SequenceEqual(list.PathParamNames)
+ && item.BuilderExpression.StartsWith(list.BuilderExpression + "[", StringComparison.Ordinal);
+ }
+}
diff --git a/tools/WrapperGenerator/EmitContext.cs b/tools/WrapperGenerator/EmitContext.cs
new file mode 100644
index 0000000000..9a738aa7f9
--- /dev/null
+++ b/tools/WrapperGenerator/EmitContext.cs
@@ -0,0 +1,9 @@
+namespace WrapperGenerator;
+
+// The per-module values CmdletEmitter's templates need, so the emitter stays module-agnostic.
+// ClientNamespace is whatever --namespace-name the module was generated with, for example
+// "Microsoft.Graph.PowerShell.Mail.Client".
+public sealed record EmitContext(string ClientNamespace, string CmdletNamespace = "MgPoC")
+{
+ public string ModelsNamespace => $"{ClientNamespace}.Models";
+}
diff --git a/tools/WrapperGenerator/GeneratorConfig.cs b/tools/WrapperGenerator/GeneratorConfig.cs
new file mode 100644
index 0000000000..0b8f90c796
--- /dev/null
+++ b/tools/WrapperGenerator/GeneratorConfig.cs
@@ -0,0 +1,5 @@
+namespace WrapperGenerator;
+
+// Configuration for a generation run. The generation service reads exactly two values: the
+// client namespace the module is generated with, and the output folder for the .g.cs files.
+public sealed record GeneratorConfig(string ClientNamespaceName, string OutputPath);
diff --git a/tools/WrapperGenerator/GeneratorExtensions.cs b/tools/WrapperGenerator/GeneratorExtensions.cs
new file mode 100644
index 0000000000..6afdad3165
--- /dev/null
+++ b/tools/WrapperGenerator/GeneratorExtensions.cs
@@ -0,0 +1,41 @@
+using System;
+using System.Linq;
+using Microsoft.OpenApi;
+
+namespace WrapperGenerator;
+
+// Small string and OpenAPI-schema helpers used across the generator.
+internal static class GeneratorExtensions
+{
+ public static string ToFirstCharacterLowerCase(this string? input)
+ => string.IsNullOrEmpty(input) ? string.Empty : char.ToLowerInvariant(input[0]) + input[1..];
+
+ public static string ToFirstCharacterUpperCase(this string? input)
+ => string.IsNullOrEmpty(input) ? string.Empty : char.ToUpperInvariant(input[0]) + input[1..];
+
+ private static readonly char[] defaultSeparators = ['-'];
+
+ public static string ToPascalCase(this string? input, params char[] separators) => ToInternalCamelCase(input, separators, true);
+
+ private static string ToInternalCamelCase(string? input, char[] separators, bool firstCharacterUpperCase = false, bool normalizeFirstCharacter = true)
+ {
+ if (string.IsNullOrEmpty(input)) return string.Empty;
+ if (separators is null || separators.Length == 0) separators = defaultSeparators;
+ var chunks = input.Split(separators, StringSplitOptions.RemoveEmptyEntries);
+ if (chunks.Length == 0) return string.Empty;
+ return ((normalizeFirstCharacter, firstCharacterUpperCase) switch
+ {
+ (false, _) => chunks[0],
+ (true, true) => chunks[0].ToFirstCharacterUpperCase(),
+ (true, false) => chunks[0].ToFirstCharacterLowerCase()
+ }) +
+ string.Join(string.Empty, chunks.Skip(1).Select(ToFirstCharacterUpperCase));
+ }
+
+ // Resolves the schema name for a $ref: a referenced schema is an OpenApiSchemaReference and
+ // carries the id. (Kiota's own reader can also recover an id from an allOf-merged schema via a
+ // marker its refiner stamps on, but this generator does not run that refiner, so no such marker
+ // is ever present and there is nothing more to resolve.)
+ internal static string? GetReferenceId(this IOpenApiSchema schema) =>
+ schema is OpenApiSchemaReference reference ? reference.Reference?.Id : null;
+}
diff --git a/tools/WrapperGenerator/IncludePathFilter.cs b/tools/WrapperGenerator/IncludePathFilter.cs
new file mode 100644
index 0000000000..fc1126e5d6
--- /dev/null
+++ b/tools/WrapperGenerator/IncludePathFilter.cs
@@ -0,0 +1,115 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Text.RegularExpressions;
+using Microsoft.OpenApi;
+
+namespace WrapperGenerator;
+
+// Trims the OpenAPI document to the requested paths/methods before generation (the generation
+// service just walks whatever paths remain).
+//
+// Each --include-path is "#METHOD1,METHOD2" (the "#..." method list is optional). A path
+// is kept if it matches any pattern's glob; on a kept path, only operations whose HTTP method
+// is in that pattern's method set survive (methods are unioned across every pattern that
+// matches the path, and a pattern with no "#..." keeps all methods). With no --include-path
+// supplied, the document is left untouched — i.e. a cmdlet is generated for every operation,
+// which is the "feed an already-filtered document" mode.
+//
+// Glob semantics, matched against the templated path keys (e.g. "/users/{user-id}/messages"):
+// ** -> any characters, including "/"
+// * -> any run of non-"/" characters (stays within one segment)
+// [s] -> a character class, passed through to the regex (so "message[s]" matches "messages")
+// everything else (including "{", "}", "-") is matched literally
+// This is intentionally minimal: it covers the operators the current include patterns use, not
+// a full glob surface.
+internal static class IncludePathFilter
+{
+ private sealed record Pattern(Regex PathRegex, HashSet Methods);
+
+ public static void Apply(OpenApiDocument document, IReadOnlyList includePaths)
+ {
+ if (includePaths.Count == 0 || document.Paths is null)
+ return;
+
+ var patterns = includePaths.Select(Parse).ToList();
+
+ foreach (var pathKey in document.Paths.Keys.ToList())
+ {
+ var allowedMethods = new HashSet(StringComparer.OrdinalIgnoreCase);
+ var allowAllMethods = false;
+ var matchedAny = false;
+
+ foreach (var pattern in patterns)
+ {
+ if (!pattern.PathRegex.IsMatch(pathKey))
+ continue;
+ matchedAny = true;
+ if (pattern.Methods.Count == 0)
+ allowAllMethods = true;
+ else
+ allowedMethods.UnionWith(pattern.Methods);
+ }
+
+ if (!matchedAny)
+ {
+ document.Paths.Remove(pathKey);
+ continue;
+ }
+
+ if (allowAllMethods)
+ continue;
+
+ var operations = document.Paths[pathKey].Operations;
+ if (operations is null)
+ continue;
+ foreach (var method in operations.Keys.ToList())
+ {
+ if (!allowedMethods.Contains(method.Method))
+ operations.Remove(method);
+ }
+ }
+ }
+
+ private static Pattern Parse(string includePath)
+ {
+ var hashIndex = includePath.IndexOf('#');
+ var glob = hashIndex >= 0 ? includePath[..hashIndex] : includePath;
+ var methodsPart = hashIndex >= 0 ? includePath[(hashIndex + 1)..] : string.Empty;
+
+ var methods = methodsPart
+ .Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
+ .ToHashSet(StringComparer.OrdinalIgnoreCase);
+
+ return new Pattern(new Regex(GlobToRegex(glob), RegexOptions.IgnoreCase), methods);
+ }
+
+ private static string GlobToRegex(string glob)
+ {
+ var sb = new StringBuilder("^");
+ for (var i = 0; i < glob.Length; i++)
+ {
+ var c = glob[i];
+ switch (c)
+ {
+ case '*' when i + 1 < glob.Length && glob[i + 1] == '*':
+ sb.Append(".*");
+ i++;
+ break;
+ case '*':
+ sb.Append("[^/]*");
+ break;
+ case '[':
+ case ']':
+ sb.Append(c); // pass a glob character class straight through to the regex
+ break;
+ default:
+ sb.Append(Regex.Escape(c.ToString()));
+ break;
+ }
+ }
+ sb.Append('$');
+ return sb.ToString();
+ }
+}
diff --git a/tools/WrapperGenerator/NamingOverrides.cs b/tools/WrapperGenerator/NamingOverrides.cs
new file mode 100644
index 0000000000..803e961a20
--- /dev/null
+++ b/tools/WrapperGenerator/NamingOverrides.cs
@@ -0,0 +1,105 @@
+using System;
+using System.Collections.Generic;
+using System.Text.RegularExpressions;
+
+namespace WrapperGenerator;
+
+// Hand-tuned naming exceptions, kept as data with a cited source on every entry.
+//
+// The published Microsoft.Graph names are mostly algorithmic, but a few come from
+// hand-written AutoRest directives in the msgraph-sdk-powershell module configs. Matching
+// the published names 100% means mirroring those directives here.
+//
+// Keep this list short. Add an entry only when the published name cannot come out of the
+// naming rules, and cite the directive that created it.
+public static partial class NamingOverrides
+{
+ private enum OverrideKind
+ {
+ SuppressOperation,
+ ReplaceNoun,
+ StripNounPrefix,
+ }
+
+ private sealed record Entry(OverrideKind Kind, string? Method, string PathPrefix, bool ExactPath, string? Value, string Reason);
+
+ private static readonly List Entries =
+ [
+ // The SDK ships no Update cmdlet for /users/{id}/calendar. Its pipeline removes the
+ // operation outright, in src/Calendar/Calendar.md: remove-path-by-operation
+ // user_UpdateCalendar. The wrapper must not invent a cmdlet the SDK chose to drop.
+ new(OverrideKind.SuppressOperation, "PATCH", "/users/{}/calendar", ExactPath: true, Value: null,
+ Reason: "Calendar.md remove-path-by-operation user_UpdateCalendar"),
+
+ // GET /users/{id}/calendar ships as Get-MgUserDefaultCalendar, renamed in
+ // src/Calendar/Calendar.md: "^(User)(Calendar)$" -> "$1Default$2".
+ new(OverrideKind.ReplaceNoun, "GET", "/users/{}/calendar", ExactPath: true, Value: "UserDefaultCalendar",
+ Reason: "Calendar.md directive renames UserCalendar to UserDefaultCalendar"),
+
+ // Most nouns under /solutions/ drop the "Solution" prefix (for example
+ // Get-MgBookingBusiness, Get-MgVirtualEventWebinar). BackupRestore is a known
+ // exception where published cmdlets keep the Solution prefix.
+ new(OverrideKind.StripNounPrefix, Method: null, "/solutions/", ExactPath: false, Value: "Solution",
+ Reason: "Bookings/VirtualEvents naming pattern under /solutions/*; BackupRestore is explicitly excluded in ApplyNounOverrides"),
+ ];
+
+ [GeneratedRegex(@"\{[^}]*\}")]
+ private static partial Regex PathParamRegex();
+
+ // Parameter names are erased before comparing, so "/users/{user-id}/calendar" and
+ // "/users/{id}/calendar" both match the "/users/{}/calendar" entries above. A spec-side
+ // parameter rename must not silently disable an override.
+ private static string NormalizePath(string pathTemplate) =>
+ PathParamRegex().Replace(pathTemplate, "{}").TrimEnd('/').ToLowerInvariant();
+
+ public static bool IsSuppressed(string httpMethod, string pathTemplate)
+ {
+ ArgumentNullException.ThrowIfNull(httpMethod);
+ ArgumentNullException.ThrowIfNull(pathTemplate);
+ var path = NormalizePath(pathTemplate);
+ foreach (var entry in Entries)
+ {
+ if (entry.Kind == OverrideKind.SuppressOperation && Matches(entry, httpMethod, path))
+ return true;
+ }
+ return false;
+ }
+
+ public static string ApplyNounOverrides(string httpMethod, string pathTemplate, string noun)
+ {
+ ArgumentNullException.ThrowIfNull(httpMethod);
+ ArgumentNullException.ThrowIfNull(pathTemplate);
+ ArgumentNullException.ThrowIfNull(noun);
+ var path = NormalizePath(pathTemplate);
+
+ // Published BackupRestore cmdlets retain the Solution prefix (for example,
+ // Get-MgSolutionBackupRestore). Do not apply /solutions/* strip rules here.
+ var skipSolutionStrip = path.StartsWith("/solutions/backuprestore", StringComparison.Ordinal);
+
+ foreach (var entry in Entries)
+ {
+ if (!Matches(entry, httpMethod, path))
+ continue;
+ switch (entry.Kind)
+ {
+ case OverrideKind.ReplaceNoun:
+ return entry.Value!;
+ case OverrideKind.StripNounPrefix when skipSolutionStrip:
+ break;
+ case OverrideKind.StripNounPrefix when noun.StartsWith(entry.Value!, StringComparison.Ordinal) && noun.Length > entry.Value!.Length:
+ noun = noun[entry.Value!.Length..];
+ break;
+ }
+ }
+ return noun;
+ }
+
+ private static bool Matches(Entry entry, string httpMethod, string normalizedPath)
+ {
+ if (entry.Method is not null && !string.Equals(entry.Method, httpMethod, StringComparison.OrdinalIgnoreCase))
+ return false;
+ return entry.ExactPath
+ ? string.Equals(normalizedPath, entry.PathPrefix, StringComparison.Ordinal)
+ : normalizedPath.StartsWith(entry.PathPrefix, StringComparison.Ordinal);
+ }
+}
diff --git a/tools/WrapperGenerator/OperationInfo.cs b/tools/WrapperGenerator/OperationInfo.cs
new file mode 100644
index 0000000000..e8ede2787d
--- /dev/null
+++ b/tools/WrapperGenerator/OperationInfo.cs
@@ -0,0 +1,20 @@
+using System.Collections.Generic;
+
+namespace WrapperGenerator;
+
+public sealed record OperationInfo(
+ string HttpMethod,
+ string Path,
+ string OperationId,
+ IReadOnlyList PathParams,
+ IReadOnlyList QueryParams,
+ bool HasBody,
+ // True when the success response wraps results in a "value" array (GET /users) rather
+ // than returning a single entity (GET /users/{id}). Path-param count alone cannot tell
+ // these apart for nested resources: a nested list and a nested get-by-id both carry the
+ // parent's path param.
+ bool IsCollectionResponse = false,
+ // Raw OpenAPI header parameter names, for example "If-Match". Graph sometimes requires
+ // these even where the spec marks them optional (Planner's PATCH/DELETE), so they become
+ // real cmdlet parameters instead of being dropped.
+ IReadOnlyList? HeaderParams = null);
diff --git a/tools/WrapperGenerator/PowerShellWrapperGenerationService.cs b/tools/WrapperGenerator/PowerShellWrapperGenerationService.cs
new file mode 100644
index 0000000000..3316b54e81
--- /dev/null
+++ b/tools/WrapperGenerator/PowerShellWrapperGenerationService.cs
@@ -0,0 +1,370 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Net.Http;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+using Microsoft.OpenApi;
+
+namespace WrapperGenerator;
+
+// Drives the "PowerShellWrapper" generation language: emits one PowerShell cmdlet class per
+// selected OpenAPI operation, straight from the OpenApiDocument that KiotaBuilder already
+// loaded and filtered with --include-path/--exclude-path. It bypasses the CodeDOM, refiner,
+// and writer pipeline, the same way PluginsGenerationService does for plugin output.
+public sealed partial class PowerShellWrapperGenerationService
+{
+ private readonly OpenApiDocument document;
+ private readonly GeneratorConfig config;
+ private readonly ILogger logger;
+
+ public PowerShellWrapperGenerationService(OpenApiDocument document, GeneratorConfig configuration, ILogger logger)
+ {
+ ArgumentNullException.ThrowIfNull(document);
+ ArgumentNullException.ThrowIfNull(configuration);
+ ArgumentNullException.ThrowIfNull(logger);
+ this.document = document;
+ config = configuration;
+ this.logger = logger;
+ }
+
+ // One GET operation from the first pass, held until we know whether it pairs with a
+ // list/item partner. CollectionValueSchema is the response's "value" array property when
+ // the response is a collection, null for a single entity. It is resolved once here so
+ // later steps never re-walk the schema.
+ private sealed record GetOperationRecord(CmdletNaming Naming, IOpenApiSchema ResponseSchema, IOpenApiSchema? CollectionValueSchema, IReadOnlyList QueryParams)
+ {
+ public bool IsCollection => CollectionValueSchema is not null;
+ }
+
+ public async Task GenerateAsync(CancellationToken cancellationToken)
+ {
+ cancellationToken.ThrowIfCancellationRequested();
+
+ var ctx = new EmitContext(ClientNamespace: config.ClientNamespaceName);
+
+ Directory.CreateDirectory(config.OutputPath);
+ foreach (var stale in Directory.GetFiles(config.OutputPath, "*.g.cs"))
+ File.Delete(stale);
+
+ await File.WriteAllTextAsync(Path.Combine(config.OutputPath, "Shared.g.cs"), CmdletEmitter.EmitSharedAuth(ctx), cancellationToken).ConfigureAwait(false);
+ LogWroteSharedFile();
+
+ var written = 0;
+ var getOperations = new List();
+
+ foreach (var (pathTemplate, pathItem) in document.Paths)
+ {
+ foreach (var (httpMethod, operation) in pathItem.Operations ?? new Dictionary())
+ {
+ cancellationToken.ThrowIfCancellationRequested();
+
+ // Skip operations the published SDK deliberately does not ship. NamingOverrides
+ // holds the citation for each one.
+ if (NamingOverrides.IsSuppressed(httpMethod.Method, pathTemplate))
+ {
+ LogSuppressedOperation(httpMethod.Method, pathTemplate);
+ continue;
+ }
+
+ var pathParams = (operation.Parameters ?? []).Where(p => p.In == ParameterLocation.Path).Select(p => p.Name!).ToList();
+ var queryParams = (operation.Parameters ?? []).Where(p => p.In == ParameterLocation.Query).Select(p => p.Name!).ToList();
+ var headerParams = (operation.Parameters ?? []).Where(p => p.In == ParameterLocation.Header).Select(p => p.Name!).ToList();
+
+ // Only GET responses need inspecting: the list/item pairing is decided by the
+ // response shape, and DELETE returns 204 with no body.
+ //
+ // The "2XX" response key and "application/json" content type are intentional,
+ // Graph-scoped assumptions, not a generic OpenAPI reader: the Graph metadata keys
+ // every success response as "2XX" and describes JSON bodies. This generator only
+ // targets Graph, so the direct indexers are deliberate. A general reader would
+ // need to fall back across 200/201/default and negotiate content types.
+ var responseSchema = httpMethod == HttpMethod.Get
+ ? TryGetSuccessJsonSchema(operation)
+ : null;
+ var collectionValueSchema = responseSchema is not null ? FindProperty(responseSchema, "value") : null;
+ var isCollection = collectionValueSchema is not null;
+
+ var operationId = operation.OperationId
+ ?? throw new InvalidOperationException($"Operation at '{pathTemplate}' ({httpMethod}) has no operationId.");
+ var opInfo = new OperationInfo(httpMethod.Method, pathTemplate, operationId, pathParams, queryParams, operation.RequestBody is not null, isCollection, headerParams);
+ var cmdletNaming = Naming.Resolve(opInfo);
+
+ if (httpMethod == HttpMethod.Get && responseSchema is null)
+ {
+ LogSkippedUnsupportedOperation(httpMethod.Method, pathTemplate, "missing supported success JSON response schema");
+ continue;
+ }
+
+ // GETs are held back: pairing is decided per noun, so it needs every GET first.
+ if (httpMethod == HttpMethod.Get)
+ {
+ getOperations.Add(new GetOperationRecord(cmdletNaming, responseSchema!, collectionValueSchema, queryParams));
+ continue;
+ }
+
+ string? source = httpMethod switch
+ {
+ _ when httpMethod == HttpMethod.Delete => CmdletEmitter.EmitRemove(cmdletNaming, ctx),
+ _ when httpMethod == HttpMethod.Post => EmitNewFor(cmdletNaming, ctx, operation),
+ _ when httpMethod == HttpMethod.Patch => EmitUpdateFor(cmdletNaming, ctx, operation),
+ _ => null,
+ };
+
+ if (source is null)
+ {
+ var reason = httpMethod == HttpMethod.Delete || httpMethod == HttpMethod.Post || httpMethod == HttpMethod.Patch
+ ? "missing supported request JSON schema"
+ : "no wrapper emitter for this HTTP method";
+ LogSkippedUnsupportedOperation(httpMethod.Method, pathTemplate, reason);
+ continue;
+ }
+
+ written += await WriteCmdletFileAsync(cmdletNaming, source, cancellationToken).ConfigureAwait(false);
+ }
+ }
+
+ written += await EmitGetOperationsAsync(getOperations, ctx, cancellationToken).ConfigureAwait(false);
+
+ LogWroteFiles(written + 1, config.OutputPath);
+ }
+
+ // Pairs a list GET (GET /users/{id}/messages) with its item GET
+ // (GET /users/{id}/messages/{message-id}) and presents them as one public Get-MgX cmdlet,
+ // matching the published SDK surface. The real work stays in two separate internal cmdlets
+ // (the *_List/*_Get classes named by Naming.WithSuffix); the public dispatcher only picks
+ // which one to invoke.
+ //
+ // A pairing is only trusted when it is structurally unambiguous: exactly one collection GET
+ // and one single-entity GET share the noun, and the item's path is the list's path plus one
+ // trailing id (Users[UserId].Messages -> Users[UserId].Messages[MessageId]). Everything
+ // else keeps the standalone shape: singleton navs with no list (GET /users/{id}/calendar),
+ // list-only endpoints such as delta queries, or an unexpected same-noun collision.
+ private async Task EmitGetOperationsAsync(List getOperations, EmitContext ctx, CancellationToken cancellationToken)
+ {
+ var written = 0;
+ var consumed = new HashSet();
+
+ var listsByNoun = getOperations.Where(o => o.IsCollection).ToLookup(o => o.Naming.Noun);
+ var itemsByNoun = getOperations.Where(o => !o.IsCollection).ToLookup(o => o.Naming.Noun);
+
+ foreach (var listGroup in listsByNoun)
+ {
+ if (listGroup.Count() != 1)
+ continue;
+ var listOp = listGroup.Single();
+
+ var itemGroup = itemsByNoun[listGroup.Key];
+ if (itemGroup.Count() != 1)
+ continue;
+ var itemOp = itemGroup.Single();
+
+ if (!Naming.IsListItemPair(listOp.Naming, itemOp.Naming))
+ continue;
+
+ if (!TryResolveListEntityTypeName(listOp.CollectionValueSchema!, ctx.ModelsNamespace, out var listEntityType)
+ || !TryResolveEntityTypeName(itemOp.ResponseSchema, ctx.ModelsNamespace, out var entityType))
+ {
+ LogSkippedUnsupportedOperation("GET", listOp.Naming.BuilderExpression, "response schema is not a resolvable $ref entity type");
+ continue;
+ }
+ var collectionResponseType = listEntityType + "CollectionResponse";
+
+ // The two real implementations: separate, independently documented cmdlets, unchanged
+ // from (and reusing) the standalone shapes used for unpaired GETs.
+ var internalListNaming = Naming.WithSuffix(listOp.Naming, "_List");
+ var internalItemNaming = Naming.WithSuffix(itemOp.Naming, "_Get");
+ var internalListSource = CmdletEmitter.EmitListGet(internalListNaming, ctx, listEntityType, collectionResponseType, listOp.QueryParams.ToHashSet());
+ var internalItemSource = CmdletEmitter.EmitItemGet(internalItemNaming, ctx, entityType);
+
+ // The thin public dispatcher on top, presenting the merged Get-MgX surface.
+ var dispatcherSource = CmdletEmitter.EmitGetDispatcher(listOp.Naming, itemOp.Naming,
+ internalListNaming, internalItemNaming, ctx, entityType, collectionResponseType, listOp.QueryParams.ToHashSet());
+
+ written += await WriteCmdletFileAsync(internalListNaming, internalListSource, cancellationToken).ConfigureAwait(false);
+ written += await WriteCmdletFileAsync(internalItemNaming, internalItemSource, cancellationToken).ConfigureAwait(false);
+ written += await WriteCmdletFileAsync(listOp.Naming, dispatcherSource, cancellationToken).ConfigureAwait(false);
+ consumed.Add(listOp);
+ consumed.Add(itemOp);
+ }
+
+ foreach (var op in getOperations)
+ {
+ if (consumed.Contains(op))
+ continue;
+
+ string? source;
+ if (op.IsCollection)
+ {
+ if (!TryResolveListEntityTypeName(op.CollectionValueSchema!, ctx.ModelsNamespace, out var listEntityType))
+ {
+ LogSkippedUnsupportedOperation("GET", op.Naming.BuilderExpression, "collection response schema is not a resolvable $ref entity type");
+ continue;
+ }
+
+ source = CmdletEmitter.EmitListGet(op.Naming, ctx, listEntityType, listEntityType + "CollectionResponse", op.QueryParams.ToHashSet());
+ }
+ else
+ {
+ if (!TryResolveEntityTypeName(op.ResponseSchema, ctx.ModelsNamespace, out var entityType))
+ {
+ LogSkippedUnsupportedOperation("GET", op.Naming.BuilderExpression, "response schema is not a resolvable $ref entity type");
+ continue;
+ }
+
+ source = CmdletEmitter.EmitItemGet(op.Naming, ctx, entityType);
+ }
+
+ written += await WriteCmdletFileAsync(op.Naming, source, cancellationToken).ConfigureAwait(false);
+ }
+
+ return written;
+ }
+
+ private async Task WriteCmdletFileAsync(CmdletNaming naming, string source, CancellationToken cancellationToken)
+ {
+ var fileName = naming.ClassName.Replace("Command", "", StringComparison.Ordinal) + ".g.cs";
+ await File.WriteAllTextAsync(Path.Combine(config.OutputPath, fileName), source, cancellationToken).ConfigureAwait(false);
+ LogWroteCmdletFile(fileName, naming.VerbName, naming.Noun);
+ return 1;
+ }
+
+ [LoggerMessage(Level = LogLevel.Information, Message = "Wrote Shared.g.cs")]
+ private partial void LogWroteSharedFile();
+ [LoggerMessage(Level = LogLevel.Information, Message = "Wrote {FileName} ({Verb}-{Noun})")]
+ private partial void LogWroteCmdletFile(string fileName, string verb, string noun);
+ [LoggerMessage(Level = LogLevel.Information, Message = "Wrote {Count} file(s) to {OutputPath}")]
+ private partial void LogWroteFiles(int count, string outputPath);
+ [LoggerMessage(Level = LogLevel.Information, Message = "Suppressed {Method} {PathTemplate}: the published SDK ships no cmdlet for it (see NamingOverrides)")]
+ private partial void LogSuppressedOperation(string method, string pathTemplate);
+ [LoggerMessage(Level = LogLevel.Warning, Message = "Skipped {Method} {PathTemplate}: {Reason}")]
+ private partial void LogSkippedUnsupportedOperation(string method, string pathTemplate, string reason);
+
+ // collectionValueSchema is the already-resolved "value" array property from
+ // GetOperationRecord, so nothing is re-walked here.
+ private static bool TryResolveListEntityTypeName(IOpenApiSchema collectionValueSchema, string modelsNamespace, out string entityTypeName)
+ {
+ entityTypeName = string.Empty;
+ var itemSchema = collectionValueSchema.Items;
+ if (itemSchema is null)
+ return false;
+ return TryResolveEntityTypeName(itemSchema, modelsNamespace, out entityTypeName);
+ }
+
+ // The old openApiDocs specs declare "value" directly on the schema; the KiotaCompat specs
+ // compose it through allOf. Look in both places, recursively for nested composition.
+ private static IOpenApiSchema? FindProperty(IOpenApiSchema schema, string propertyName)
+ {
+ if (schema.Properties?.TryGetValue(propertyName, out var direct) == true)
+ return direct;
+
+ foreach (var branch in schema.AllOf ?? [])
+ {
+ if (FindProperty(branch, propertyName) is { } found)
+ return found;
+ }
+
+ return null;
+ }
+
+ private static string? EmitNewFor(CmdletNaming naming, EmitContext ctx, OpenApiOperation operation)
+ {
+ // "application/json" is an intentional, Graph-scoped assumption: Graph request bodies are
+ // JSON, so the content type is indexed directly rather than negotiated. See the matching
+ // note on the response lookup in GenerateAsync.
+ var bodySchema = TryGetRequestJsonSchema(operation);
+ if (bodySchema is null)
+ return null;
+ if (!TryResolveEntityTypeName(bodySchema, ctx.ModelsNamespace, out var entityType))
+ return null;
+ return CmdletEmitter.EmitNew(naming, ctx, entityType,
+ SchemaProperties.ExtractPrimitiveProperties(bodySchema), SchemaProperties.HasPasswordProfile(bodySchema));
+ }
+
+ private static string? EmitUpdateFor(CmdletNaming naming, EmitContext ctx, OpenApiOperation operation)
+ {
+ // "application/json" is an intentional, Graph-scoped assumption (see EmitNewFor).
+ var bodySchema = TryGetRequestJsonSchema(operation);
+ if (bodySchema is null)
+ return null;
+ if (!TryResolveEntityTypeName(bodySchema, ctx.ModelsNamespace, out var entityType))
+ return null;
+ return CmdletEmitter.EmitUpdate(naming, ctx, entityType,
+ SchemaProperties.ExtractPrimitiveProperties(bodySchema), SchemaProperties.HasPasswordProfile(bodySchema));
+ }
+
+ private static IOpenApiSchema? TryGetSuccessJsonSchema(OpenApiOperation operation)
+ {
+ if (operation.Responses is null)
+ return null;
+
+ foreach (var key in new[] { "2XX", "200", "201", "default" })
+ {
+ if (!operation.Responses.TryGetValue(key, out var response) || response?.Content is null)
+ continue;
+
+ var schema = TryGetJsonSchemaFromContent(response.Content);
+ if (schema is not null)
+ return schema;
+ }
+
+ return null;
+ }
+
+ private static IOpenApiSchema? TryGetRequestJsonSchema(OpenApiOperation operation)
+ {
+ var content = operation.RequestBody?.Content;
+ if (content is null)
+ return null;
+ return TryGetJsonSchemaFromContent(content);
+ }
+
+ private static IOpenApiSchema? TryGetJsonSchemaFromContent(IDictionary content)
+ {
+ if (content.TryGetValue("application/json", out var exactJson) && exactJson?.Schema is not null)
+ return exactJson.Schema;
+
+ foreach (var (contentType, mediaType) in content)
+ {
+ if (contentType.StartsWith("application/json", StringComparison.OrdinalIgnoreCase)
+ || contentType.EndsWith("+json", StringComparison.OrdinalIgnoreCase))
+ {
+ if (mediaType?.Schema is not null)
+ return mediaType.Schema;
+ }
+ }
+
+ return null;
+ }
+
+ private static bool TryResolveEntityTypeName(IOpenApiSchema schema, string modelsNamespace, out string entityTypeName)
+ {
+ entityTypeName = string.Empty;
+ var id = schema.GetReferenceId();
+ if (string.IsNullOrEmpty(id))
+ return false;
+ entityTypeName = SchemaNameToTypeName(id, modelsNamespace);
+ return true;
+ }
+
+ private static string ResolveReferenceId(IOpenApiSchema schema) =>
+ schema.GetReferenceId() is string id && !string.IsNullOrEmpty(id)
+ ? id
+ : throw new InvalidOperationException("Expected a $ref schema for entity type resolution.");
+
+ private static string SchemaNameToTypeName(string schemaName, string modelsNamespace)
+ {
+ var name = schemaName.StartsWith("microsoft.graph.", StringComparison.Ordinal)
+ ? schemaName["microsoft.graph.".Length..]
+ : schemaName;
+
+ // Kiota nests each dot segment as a sub-namespace under Models ("security.alert"
+ // becomes Models.Security.Alert). A using directive does not reach into nested
+ // namespaces, so multi-segment names are fully qualified; single-segment names,
+ // the common case, stay bare.
+ var segments = name.Split('.').Select(static segment => char.ToUpperInvariant(segment[0]) + segment[1..]).ToArray();
+ return segments.Length == 1 ? segments[0] : $"{modelsNamespace}.{string.Join('.', segments)}";
+ }
+}
diff --git a/tools/WrapperGenerator/Program.cs b/tools/WrapperGenerator/Program.cs
new file mode 100644
index 0000000000..837357fc7c
--- /dev/null
+++ b/tools/WrapperGenerator/Program.cs
@@ -0,0 +1,92 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Text.Json;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging.Abstractions;
+using Microsoft.OpenApi;
+using Microsoft.OpenApi.Reader;
+
+namespace WrapperGenerator;
+
+// Entry point: loads an OpenAPI document from a file, applies --include-path filtering, builds
+// the run configuration, and calls PowerShellWrapperGenerationService.GenerateAsync.
+internal static class Program
+{
+ private static readonly JsonSerializerOptions LockFileJsonOptions = new() { WriteIndented = true };
+
+ private static async Task Main(string[] args)
+ {
+ string? specPath = null;
+ string? outputPath = null;
+ string? clientNamespace = null;
+ var includePaths = new List();
+
+ for (var i = 0; i < args.Length; i++)
+ {
+ switch (args[i])
+ {
+ case "-d" or "--openapi":
+ specPath = ArgValue(args, ref i);
+ break;
+ case "-o" or "--output":
+ outputPath = ArgValue(args, ref i);
+ break;
+ case "-n" or "--namespace" or "--namespace-name":
+ clientNamespace = ArgValue(args, ref i);
+ break;
+ case "--include-path":
+ includePaths.Add(ArgValue(args, ref i));
+ break;
+ case "-c" or "--class-name":
+ // Accepted for parity with the kiota command line; the emitter hardcodes the
+ // client type name, so this tool does not use it.
+ ArgValue(args, ref i);
+ break;
+ default:
+ Console.Error.WriteLine($"Unknown argument: {args[i]}");
+ return 2;
+ }
+ }
+
+ if (specPath is null || outputPath is null || clientNamespace is null)
+ {
+ Console.Error.WriteLine(
+ "Usage: WrapperGenerator -d -o