users.mailFolder

Update child folder from user

patch/users/{userIdentifier}/mailFolders/{mailFolderId}/childFolders/{mailFolderId1}

Request body

@odata.typestring

idstring

The unique identifier for an entity. Read-only

childFolderCountnumber nullable

The number of immediate child mailFolders in the current mailFolder

parentFolderIdstring nullable

The unique identifier for the mailFolder's parent mailFolder

displayNamestring nullable

The mailFolder's display name

unreadItemCountnumber nullable

The number of items in the mailFolder marked as unread

isHiddenboolean nullable

Indicates whether the mailFolder is hidden. This property can be set only when creating the folder

totalItemCountnumber nullable

The number of items in the mailFolder

Response

If successful, returns the updated child folder object in the specified user's mailbox. Unless, the folder may not exist or the request body may be invalid.

@odata.typestring

idstring

The unique identifier for an entity. Read-only

childFolderCountnumber nullable

The number of immediate child mailFolders in the current mailFolder

parentFolderIdstring nullable

The unique identifier for the mailFolder's parent mailFolder

displayNamestring nullable

The mailFolder's display name

unreadItemCountnumber nullable

The number of items in the mailFolder marked as unread

isHiddenboolean nullable

Indicates whether the mailFolder is hidden. This property can be set only when creating the folder

totalItemCountnumber nullable

The number of items in the mailFolder

Changes

Changed in 3 of the 10 revisions of this API.13

Jul 17, 2026af62694b9f2d2See the full diff
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
Jun 18, 2026990ed583c3851See the full diff
- ○
  endpoint added
  endpoint-added
May 26, 2026c6fc1d98f5281See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation