Organization Exclusions from Retention Policy

The /Organizations/{organizationId}/RetentionExclusion resource collection represents items excluded from the retention policy for a specified organization.

NOTE
Excluding items using the organization ID overrides the global exclusion list.

Get Excluded Items

Returns a list of items that have been excluded from the retention policy for an organization with the specified ID.

SecurityBearer
Request
path Parameters
organizationId
required
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

Responses
200

OK

default

Operation failure response.

get/v8/Organizations/{organizationId}/RetentionExclusion
Request samples
Response samples
application/json
{
  • "contacts": true,
  • "calendar": true
}

Edit Excluded Items List

Modifies a list of items that have been excluded from the retention policy for an organization with the specified ID.

x-codegen-request-body-name: exclusion
SecurityBearer
Request
path Parameters
organizationId
required
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

Request Body schema: application/json
required
contacts
boolean

Defines whether the Contacts folder will be removed by the retention policy.

calendar
boolean

Defines whether the Calendar folder will be removed by the retention policy.

Responses
204

No Content

default

Operation failure response.

put/v8/Organizations/{organizationId}/RetentionExclusion
Request samples
application/json
{
  • "contacts": true,
  • "calendar": true
}
Response samples
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}

Remove Excluded Items

Removes items from a list of items excluded from the retention policy for an organization with the specified ID.

SecurityBearer
Request
path Parameters
organizationId
required
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

Responses
204

No Content

default

Operation failure response.

delete/v8/Organizations/{organizationId}/RetentionExclusion
Request samples
Response samples
application/json
{
  • "message": "string",
  • "errorCode": "ProxyOffline",
  • "stackTrace": "string"
}

Document updated 12/18/2025

Page content applies to build 8.3.0.2201