OpenAPI Specification
openapi: 3.1.0
info:
title: Microsoft Graph Privacy
description: Needs a description.
paths:
/privacy:
description: Provides operations to manage the privacy singleton.
get:
tags:
- Privacy.privacy
summary: Microsoft Graph Get privacy
operationId: privacy.privacy.GetPrivacy
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 entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.privacy'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Privacy.privacy
summary: Microsoft Graph Update privacy
operationId: privacy.privacy.UpdatePrivacy
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.privacy'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.privacy'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/privacy/subjectRightsRequests:
description: >-
Provides operations to manage the subjectRightsRequests property of the
microsoft.graph.privacy entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph List subjectRightsRequests
description: Get a list of subjectRightsRequest objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/subjectrightsrequest-list?view=graph-rest-1.0
operationId: privacy.ListSubjectRightsRequests
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.subjectRightsRequestCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Create subjectRightsRequest
description: Create a new subjectRightsRequest object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/subjectrightsrequest-post?view=graph-rest-1.0
operationId: privacy.CreateSubjectRightsRequests
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subjectRightsRequest'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subjectRightsRequest'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
/privacy/subjectRightsRequests/{subjectRightsRequest-id}:
description: >-
Provides operations to manage the subjectRightsRequests property of the
microsoft.graph.privacy entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get subjectRightsRequest
description: Read the properties and relationships of a subjectRightsRequest object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/subjectrightsrequest-get?view=graph-rest-1.0
operationId: privacy.GetSubjectRightsRequests
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.subjectRightsRequest'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
patch:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Update subjectRightsRequest
description: Update the properties of a subjectRightsRequest object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/subjectrightsrequest-update?view=graph-rest-1.0
operationId: privacy.UpdateSubjectRightsRequests
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subjectRightsRequest'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.subjectRightsRequest'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
delete:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Delete navigation property subjectRightsRequests for privacy
operationId: privacy.DeleteSubjectRightsRequests
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers:
description: >-
Provides operations to manage the approvers property of the
microsoft.graph.subjectRightsRequest entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get approvers from privacy
description: >-
Collection of users who can approve the request. Currently only
supported for requests of type delete.
operationId: privacy.subjectRightsRequests.ListApprovers
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.userCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/{user-id}:
description: >-
Provides operations to manage the approvers property of the
microsoft.graph.subjectRightsRequest entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get approvers from privacy
description: >-
Collection of users who can approve the request. Currently only
supported for requests of type delete.
operationId: privacy.subjectRightsRequests.GetApprovers
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.user'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: user-id
in: path
description: The unique identifier of user
required: true
schema:
type: string
x-ms-docs-key-type: user
x-ms-docs-grouped-path:
- >-
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers(userPrincipalName='{userPrincipalName}')
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/{user-id}/mailboxSettings:
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get mailboxSettings property value
description: >-
Settings for the primary mailbox of the signed-in user. You can get or
update settings for sending automatic replies to incoming messages,
locale, and time zone. Returned only on $select.
operationId: privacy.subjectRightsRequests.approvers.GetMailboxSettings
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: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
patch:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Update property mailboxSettings value.
operationId: privacy.subjectRightsRequests.approvers.UpdateMailboxSettings
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'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: user-id
in: path
description: The unique identifier of user
required: true
schema:
type: string
x-ms-docs-key-type: user
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/{user-id}/serviceProvisioningErrors:
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph 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: privacy.subjectRightsRequests.approvers.ListServiceProvisioningErrors
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.serviceProvisioningErrorCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: user-id
in: path
description: The unique identifier of user
required: true
schema:
type: string
x-ms-docs-key-type: user
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/{user-id}/serviceProvisioningErrors/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get the number of the resource
operationId: >-
privacy.subjectRightsRequests.approvers.ServiceProvisioningErrors.GetCount-6b48
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: user-id
in: path
description: The unique identifier of user
required: true
schema:
type: string
x-ms-docs-key-type: user
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers(userPrincipalName='{userPrincipalName}'):
description: >-
Provides operations to manage the approvers property of the
microsoft.graph.subjectRightsRequest entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get approvers from privacy
description: >-
Collection of users who can approve the request. Currently only
supported for requests of type delete.
operationId: privacy.subjectRightsRequests.approvers.GetByUserPrincipalName
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.user'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: userPrincipalName
in: path
description: Alternate key of user
required: true
schema:
type: string
nullable: true
x-ms-docs-grouped-path:
- >-
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/{user-id}
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/approvers/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get the number of the resource
operationId: privacy.subjectRightsRequests.approvers.GetCount-f1ed
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/collaborators:
description: >-
Provides operations to manage the collaborators property of the
microsoft.graph.subjectRightsRequest entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get collaborators from privacy
description: Collection of users who can collaborate on the request.
operationId: privacy.subjectRightsRequests.ListCollaborators
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.userCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/collaborators/{user-id}:
description: >-
Provides operations to manage the collaborators property of the
microsoft.graph.subjectRightsRequest entity.
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get collaborators from privacy
description: Collection of users who can collaborate on the request.
operationId: privacy.subjectRightsRequests.GetCollaborators
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.user'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The subject rights request API under Privacy is deprecated and will
stop working on March 22, 2025. Please use the new API under
Security.
x-ms-docs-operation-type: operation
parameters:
- name: subjectRightsRequest-id
in: path
description: The unique identifier of subjectRightsRequest
required: true
schema:
type: string
x-ms-docs-key-type: subjectRightsRequest
- name: user-id
in: path
description: The unique identifier of user
required: true
schema:
type: string
x-ms-docs-key-type: user
x-ms-docs-grouped-path:
- >-
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/collaborators(userPrincipalName='{userPrincipalName}')
/privacy/subjectRightsRequests/{subjectRightsRequest-id}/collaborators/{user-id}/mailboxSettings:
get:
tags:
- privacy.subjectRightsRequest
summary: Microsoft Graph Get mailboxSettings property value
description: >-
Settings for the primary mailbox of the signed-in user. You can get or
update settings for sending automatic replies to incoming messages,
locale, and time zone. Returned only on $select.
operationId: privacy.subjectRightsRequests.collaborators.GetMailboxSettings
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: Entity result.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mailboxSettings'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
removalDate: '2025-03-20'
date: '2022-03-22'
version: 2022-02/PrivacyDeprecate
description: >-
The
# --- truncated at 32 KB (137 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/privacy-openapi-original.yml