diff --git a/config/ModulesMapping.jsonc b/config/ModulesMapping.jsonc
index 2564e91c99..c094324282 100644
--- a/config/ModulesMapping.jsonc
+++ b/config/ModulesMapping.jsonc
@@ -25,7 +25,7 @@
// "Identity.Governance": "^accessReviews\\.|^businessFlowTemplates\\.|^programs\\.|^programControls\\.|^programControlTypes\\.|^privilegedRoles\\.|^privilegedRoleAssignments\\.|^privilegedRoleAssignmentRequests\\.|^privilegedApproval\\.|^privilegedOperationEvents\\.|^privilegedAccess\\.|^agreements\\.|^users.agreementAcceptance$|^identityGovernance\\.|^roleManagement.rbacApplication$|^roleManagement.*.Functions$|roleManagement.*.Actions$",
// "Identity.SignIns": "^organization.certificateBasedAuthConfiguration$|^invitations\\.|^identityProviders\\.|^oauth2PermissionGrants\\.|^identityProtection\\.|^dataPolicyOperations\\.|^identity\\.|^trustFramework\\.|^informationProtection\\.|^policies\\.|^users.authentication$|^users.informationProtection$|^tenantRelationships.multiTenantOrganization$",
// "Identity.Partner": "^tenantRelationships.delegatedAdminRelationship$|^tenantRelationships.delegatedAdminCustomer$",
- // "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$",
+ "Mail": "^users.inferenceClassification$|^users.mailFolder$|^users.message$",
// "ManagedTenants": "^tenantRelationships.managedTenant$",
// "NetworkAccess": "^networkAccess\\.",
// "Notes": "^users.onenote$|^groups.onenote$|^sites.onenote$",
@@ -36,10 +36,10 @@
// "SchemaExtensions": "^schemaExtensions\\.",
// "Search": "^search\\.|^external\\.",
//"Security": "^security\\.|^users.security$",
- "Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$",
+ //"Sites": "^sites.baseSitePage$|^sites.site$|^sites.itemAnalytics$|^sites.columnDefinition$|^sites.contentType$|^sites.drive$|^sites.list$|^sites.sitePage$|^sites.permission$|^sites.store$|^users.site$|^groups.site$|^sites.*.Functions$|^sites.*.Actions$|^sites.richLongRunningOperation$|^termStore.sets.ListChildren$|^admin.sharepoint$",
//"Teams": "^teams\\.|^chats\\.|^users.chat$|^appCatalogs.teamsApp$|^users.userTeamwork$|^teamwork\\.|^users.team$|^groups.team$",
// "Users": "^users.user$|^users.directoryObject$|^users.licenseDetails$|^users.mailboxSettings|^users.notification$|^users.outlookUser$|^users.profilePhoto$|^users.userSettings$|^users.extension$|^users.oAuth2PermissionGrant$|^users.todo$|^users.itemInsights$|^users.servicePrincipal$",
- //"Users.Actions": "^users.*.Actions$",
+ "Users.Actions": "^users.*.Actions$",
//"Users.Functions": "^users.*.Functions$",
//"WindowsUpdates": "^admin.adminWindows$"
}
\ No newline at end of file
diff --git a/openApiDocs/beta/Mail.yml b/openApiDocs/beta/Mail.yml
index 0312041c94..ccedc36d38 100644
--- a/openApiDocs/beta/Mail.yml
+++ b/openApiDocs/beta/Mail.yml
@@ -51,11 +51,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.inferenceClassification'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -87,11 +82,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.inferenceClassification'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/inferenceClassification/overrides':
get:
@@ -149,11 +139,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.inferenceClassificationOverrideCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -188,11 +173,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.inferenceClassificationOverride'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/inferenceClassification/overrides/{inferenceClassificationOverride-id}':
get:
@@ -247,11 +227,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.inferenceClassificationOverride'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -291,11 +266,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.inferenceClassificationOverride'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -330,11 +300,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/inferenceClassification/overrides/$count':
get:
@@ -358,11 +323,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
'/users/{user-id}/mailFolders':
get:
tags:
@@ -426,11 +386,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.mailFolderCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -465,11 +420,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}':
get:
@@ -531,11 +481,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -575,11 +520,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -614,11 +554,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders':
get:
@@ -691,11 +626,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.mailFolderCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -738,11 +668,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}':
get:
@@ -812,11 +737,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -864,11 +784,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -911,11 +826,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules':
get:
@@ -989,11 +899,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.messageRuleCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -1044,11 +949,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.messageRule'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/{messageRule-id}':
get:
@@ -1119,11 +1019,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.messageRule'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -1179,11 +1074,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.messageRule'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -1234,11 +1124,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messageRules/$count':
get:
@@ -1278,11 +1163,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages':
get:
tags:
@@ -1355,11 +1235,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -1410,11 +1285,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}':
get:
@@ -1485,11 +1355,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -1545,11 +1410,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -1600,11 +1460,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/$value':
get:
@@ -1656,11 +1511,6 @@ paths:
format: binary
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
put:
tags:
- users.mailFolder
@@ -1713,11 +1563,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
delete:
tags:
- users.mailFolder
@@ -1768,11 +1613,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments':
get:
tags:
@@ -1853,11 +1693,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -1916,11 +1751,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.attachment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/{attachment-id}':
get:
@@ -1999,11 +1829,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.attachment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -2062,11 +1887,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/$count':
get:
@@ -2114,11 +1934,71 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to an Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message.attachment_createUploadSession
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions':
get:
tags:
@@ -2199,11 +2079,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -2262,11 +2137,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/{extension-id}':
get:
@@ -2345,11 +2215,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
@@ -2413,11 +2278,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -2476,11 +2336,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions/$count':
get:
@@ -2528,11 +2383,6 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/mentions':
get:
tags:
@@ -2613,11 +2463,6 @@ paths:
$ref: '#/components/responses/microsoft.graph.mentionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -2676,11 +2521,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mention'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/mentions/{mention-id}':
get:
@@ -2759,11 +2599,6 @@ paths:
$ref: '#/components/schemas/microsoft.graph.mention'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
@@ -2822,11 +2657,6 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/mentions/$count':
get:
@@ -2874,17 +2704,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/$count':
- get:
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.copy':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.childFolder.message_GetCount
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_copy
parameters:
- name: user-id
in: path
@@ -2910,24 +2739,46 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createForward':
+ post:
tags:
- users.mailFolder
- summary: Get userConfigurations from users
- operationId: user.mailFolder.childFolder_ListUserConfiguration
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_createForward
parameters:
- name: user-id
in: path
@@ -2953,61 +2804,53 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $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
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.userConfigurationCollectionResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations/{userConfiguration-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReply':
+ post:
tags:
- users.mailFolder
- summary: Get userConfigurations from users
- operationId: user.mailFolder.childFolder_GetUserConfiguration
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_createReply
parameters:
- name: user-id
in: path
@@ -3033,55 +2876,49 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: userConfiguration-id
+ - name: message-id
in: path
- description: The unique identifier of userConfiguration
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: userConfiguration
- - 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: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.userConfiguration'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.childFolder.userConfiguration_GetCount
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft message later. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_createReplyAll
parameters:
- name: user-id
in: path
@@ -3107,24 +2944,49 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.forward':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.childFolder_GetCount
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_forward
parameters:
- name: user-id
in: path
@@ -3142,96 +3004,57 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- responses:
- 2XX:
- $ref: '#/components/responses/ODataCountResponse'
- default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules':
- get:
- tags:
- - users.mailFolder
- summary: Get messageRules from users
- description: The collection of rules that apply to the user's Inbox folder.
- operationId: user.mailFolder_ListMessageRule
- parameters:
- - name: user-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of user
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: user
- - name: mailFolder-id
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - $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
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.messageRuleCollectionResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.markAsJunk':
post:
tags:
- users.mailFolder
- summary: Create new navigation property to messageRules for users
- operationId: user.mailFolder_CreateMessageRule
+ summary: Invoke action markAsJunk
+ description: 'Mark a message as junk. This API adds the sender to the list of blocked senders and moves the message to the Junk Email folder, when moveToJunk is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasjunk?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_markAsJunk
parameters:
- name: user-id
in: path
@@ -3249,35 +3072,55 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ type: object
+ properties:
+ MoveToJunk:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.markAsNotJunk':
+ post:
tags:
- users.mailFolder
- summary: Get messageRules from users
- description: The collection of rules that apply to the user's Inbox folder.
- operationId: user.mailFolder_GetMessageRule
+ summary: Invoke action markAsNotJunk
+ description: 'Mark a message as not junk. This API removes the sender from the list of blocked senders and moves the message to the Inbox folder, when moveToInbox is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasnotjunk?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_markAsNotJunk
parameters:
- name: user-id
in: path
@@ -3295,54 +3138,55 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
- - 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
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ MoveToInbox:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.move':
+ post:
tags:
- users.mailFolder
- summary: Update the navigation property messageRules in users
- operationId: user.mailFolder_UpdateMessageRule
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_move
parameters:
- name: user-id
in: path
@@ -3360,20 +3204,33 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -3381,20 +3238,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.permanentDelete':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property messageRules for users
- operationId: user.mailFolder_DeleteMessageRule
+ summary: Invoke action permanentDelete
+ description: 'Permanently delete a message and place it in the Purges folder in the dumpster in the user''s mailbox. Email clients such as Outlook or Outlook on the web can''t access permanently deleted items. Unless there''s a hold set on the mailbox, the items are permanently deleted after a set period of time. For more information about item retention, see Configure Deleted Item retention and Recoverable Items quotas.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-permanentdelete?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_permanentDelete
parameters:
- name: user-id
in: path
@@ -3412,37 +3269,260 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
- - name: If-Match
- in: header
- description: ETag
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
style: simple
schema:
type: string
+ x-ms-docs-key-type: message
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/$count':
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.reply':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_reply
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_replyAll
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.send':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_send
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.unsubscribe':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action unsubscribe
+ description: 'Submits an email request on behalf of the signed-in user to unsubscribe from an email distribution list. Uses the information in the List-Unsubscribe header. Message senders can use mailing lists in a user-friendly way by including an option for recipients to opt out. They can do so by specifying the List-Unsubscribe header in each message following RFC-2369. Note In particular, for the unsubscribe action to work, the sender must specify mailto: and not URL-based unsubscribe information. Setting that header would also set the unsubscribeEnabled property of the message instance to true, and the unsubscribeData property to the header data. If the unsubscribeEnabled property of a message is true, you can use the unsubscribe action to unsubscribe the user from similar future messages as managed by the message sender. A successful unsubscribe action moves the message to the Deleted Items folder. The actual exclusion of the user from future mail distribution is managed by the sender.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-unsubscribe?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_unsubscribe
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/$count':
get:
tags:
- users.mailFolder
summary: Get the number of the resource
- operationId: user.mailFolder.messageRule_GetCount
+ operationId: user.mailFolder.childFolder.message_GetCount
parameters:
- name: user-id
in: path
@@ -3460,6 +3540,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -3467,18 +3555,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages':
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/microsoft.graph.delta()':
get:
tags:
- users.mailFolder
- summary: Get messages from users
- description: The collection of messages in the mailFolder.
- operationId: user.mailFolder_ListMessage
+ summary: Invoke function delta
+ description: "Get a set of messages that were added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). Using deltas allows you toincrementally maintain and synchronize a local store of a user's messages."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder.message_delta
parameters:
- name: user-id
in: path
@@ -3496,14 +3582,29 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- - name: $orderby
+ - name: $select
in: query
- description: Order items by property values
+ description: Select properties to be returned
style: form
explode: false
schema:
@@ -3511,9 +3612,9 @@ paths:
type: array
items:
type: string
- - name: $select
+ - name: $orderby
in: query
- description: Select properties to be returned
+ description: Order items by property values
style: form
explode: false
schema:
@@ -3533,23 +3634,2624 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ '@odata.deltaLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
- x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.copy':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action copy
+ description: Copy a mail folder and its contents to another mail folder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-copy?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder_copy
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.move':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action move
+ description: Move a mail folder and its contents to another mail folder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-move?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder_move
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.permanentDelete':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action permanentDelete
+ description: 'Permanently delete a mail folder and remove its items from the user''s mailbox. For more information about item retention, see Configure Deleted Item retention and Recoverable Items quotas.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-permanentdelete?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder_permanentDelete
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.updateAllMessagesReadState':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action updateAllMessagesReadState
+ operationId: user.mailFolder.childFolder_updateAllMessagesReadState
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ isRead:
+ type: boolean
+ default: false
+ nullable: true
+ suppressReadReceipts:
+ type: boolean
+ default: false
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ deprecated: true
+ x-ms-deprecation:
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/operations':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get operations from users
+ operationId: user.mailFolder.childFolder_ListOperation
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.mailFolderOperationCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ deprecated: true
+ x-ms-deprecation:
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/operations/{mailFolderOperation-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get operations from users
+ operationId: user.mailFolder.childFolder_GetOperation
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolderOperation-id
+ in: path
+ description: The unique identifier of mailFolderOperation
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolderOperation
+ - 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.mailFolderOperation'
+ default:
+ $ref: '#/components/responses/error'
+ deprecated: true
+ x-ms-deprecation:
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/operations/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.childFolder.operation_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ deprecated: true
+ x-ms-deprecation:
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get userConfigurations from users
+ operationId: user.mailFolder.childFolder_ListUserConfiguration
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.userConfigurationCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations/{userConfiguration-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get userConfigurations from users
+ operationId: user.mailFolder.childFolder_GetUserConfiguration
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: userConfiguration-id
+ in: path
+ description: The unique identifier of userConfiguration
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: userConfiguration
+ - 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.userConfiguration'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/userConfigurations/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.childFolder.userConfiguration_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.childFolder_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Invoke function delta
+ description: "Get a set of mail folders that have been added, deleted, or removed from the user's mailbox. A delta function call for mail folders in a mailbox is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls,\nyou can query for incremental changes in the mail folders. This allows you to maintain and synchronize\na local store of a user's mail folders without having to fetch all the mail folders of that mailbox from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-delta?view=graph-rest-beta
+ operationId: user.mailFolder.childFolder_delta
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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:
+ 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:
+ title: Collection of mailFolder
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messageRules from users
+ description: The collection of rules that apply to the user's Inbox folder.
+ operationId: user.mailFolder_ListMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.messageRuleCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to messageRules for users
+ operationId: user.mailFolder_CreateMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messageRules from users
+ description: The collection of rules that apply to the user's Inbox folder.
+ operationId: user.mailFolder_GetMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ - 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.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property messageRules in users
+ operationId: user.mailFolder_UpdateMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property messageRules for users
+ operationId: user.mailFolder_DeleteMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.messageRule_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messages from users
+ description: The collection of messages in the mailFolder.
+ operationId: user.mailFolder_ListMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.messageCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to messages for users
+ operationId: user.mailFolder_CreateMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messages from users
+ description: The collection of messages in the mailFolder.
+ operationId: user.mailFolder_GetMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - 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.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property messages in users
+ operationId: user.mailFolder_UpdateMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property messages for users
+ operationId: user.mailFolder_DeleteMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/$value':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get media content for the navigation property messages from users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_GetMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Retrieved media content
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ default:
+ $ref: '#/components/responses/error'
+ put:
+ tags:
+ - users.mailFolder
+ summary: Update media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_SetMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New media content.
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_DeleteMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.mailFolder.message_ListAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $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.attachmentCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to attachments for users
+ operationId: user.mailFolder.message_CreateAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/{attachment-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.mailFolder.message_GetAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
+ - 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.attachment'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property attachments for users
+ operationId: user.mailFolder.message_DeleteAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message.attachment_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to an Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-beta
+ operationId: user.mailFolder.message.attachment_createUploadSession
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.mailFolder.message_ListExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $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.extensionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to extensions for users
+ operationId: user.mailFolder.message_CreateExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/{extension-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.mailFolder.message_GetExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ - 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.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property extensions in users
+ operationId: user.mailFolder.message_UpdateExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property extensions for users
+ operationId: user.mailFolder.message_DeleteExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message.extension_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get mentions from users
+ description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
+ operationId: user.mailFolder.message_ListMention
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $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.mentionCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to mentions for users
+ operationId: user.mailFolder.message_CreateMention
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mention'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mention'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions/{mention-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get mentions from users
+ description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
+ operationId: user.mailFolder.message_GetMention
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: mention-id
+ in: path
+ description: The unique identifier of mention
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mention
+ - 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.mention'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property mentions for users
+ operationId: user.mailFolder.message_DeleteMention
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: mention-id
+ in: path
+ description: The unique identifier of mention
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mention
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message.mention_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.copy':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-beta
+ operationId: user.mailFolder.message_copy
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createForward':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-beta
+ operationId: user.mailFolder.message_createForward
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createReply':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-beta
+ operationId: user.mailFolder.message_createReply
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft message later. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-beta
+ operationId: user.mailFolder.message_createReplyAll
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.forward':
post:
tags:
- users.mailFolder
- summary: Create new navigation property to messages for users
- operationId: user.mailFolder_CreateMessage
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-beta
+ operationId: user.mailFolder.message_forward
parameters:
- name: user-id
in: path
@@ -3567,35 +6269,49 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.markAsJunk':
+ post:
tags:
- users.mailFolder
- summary: Get messages from users
- description: The collection of messages in the mailFolder.
- operationId: user.mailFolder_GetMessage
+ summary: Invoke action markAsJunk
+ description: 'Mark a message as junk. This API adds the sender to the list of blocked senders and moves the message to the Junk Email folder, when moveToJunk is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasjunk?view=graph-rest-beta
+ operationId: user.mailFolder.message_markAsJunk
parameters:
- name: user-id
in: path
@@ -3621,46 +6337,39 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - 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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ MoveToJunk:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.markAsNotJunk':
+ post:
tags:
- users.mailFolder
- summary: Update the navigation property messages in users
- operationId: user.mailFolder_UpdateMessage
+ summary: Invoke action markAsNotJunk
+ description: 'Mark a message as not junk. This API removes the sender from the list of blocked senders and moves the message to the Inbox folder, when moveToInbox is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasnotjunk?view=graph-rest-beta
+ operationId: user.mailFolder.message_markAsNotJunk
parameters:
- name: user-id
in: path
@@ -3687,11 +6396,17 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ type: object
+ properties:
+ MoveToInbox:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -3702,17 +6417,17 @@ paths:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.move':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property messages for users
- operationId: user.mailFolder_DeleteMessage
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-beta
+ operationId: user.mailFolder.message_move
parameters:
- name: user-id
in: path
@@ -3738,30 +6453,38 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/$value':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.permanentDelete':
+ post:
tags:
- users.mailFolder
- summary: Get media content for the navigation property messages from users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_GetMessagesContent
+ summary: Invoke action permanentDelete
+ description: 'Permanently delete a message and place it in the Purges folder in the dumpster in the user''s mailbox. Email clients such as Outlook or Outlook on the web can''t access permanently deleted items. Unless there''s a hold set on the mailbox, the items are permanently deleted after a set period of time. For more information about item retention, see Configure Deleted Item retention and Recoverable Items quotas.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-permanentdelete?view=graph-rest-beta
+ operationId: user.mailFolder.message_permanentDelete
parameters:
- name: user-id
in: path
@@ -3789,25 +6512,20 @@ paths:
x-ms-docs-key-type: message
responses:
2XX:
- description: Retrieved media content
- content:
- application/octet-stream:
- schema:
- type: string
- format: binary
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- put:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.reply':
+ post:
tags:
- users.mailFolder
- summary: Update media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_SetMessagesContent
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-beta
+ operationId: user.mailFolder.message_reply
parameters:
- name: user-id
in: path
@@ -3834,29 +6552,36 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New media content.
+ description: Action parameters
content:
- application/octet-stream:
+ application/json:
schema:
- type: string
- format: binary
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
tags:
- users.mailFolder
- summary: Delete media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_DeleteMessagesContent
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-beta
+ operationId: user.mailFolder.message_replyAll
parameters:
- name: user-id
in: path
@@ -3882,29 +6607,37 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.send':
+ post:
tags:
- users.mailFolder
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.mailFolder.message_ListAttachment
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-beta
+ operationId: user.mailFolder.message_send
parameters:
- name: user-id
in: path
@@ -3930,60 +6663,22 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $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.attachmentCollectionResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.unsubscribe':
post:
tags:
- users.mailFolder
- summary: Create new navigation property to attachments for users
- operationId: user.mailFolder.message_CreateAttachment
+ summary: Invoke action unsubscribe
+ description: 'Submits an email request on behalf of the signed-in user to unsubscribe from an email distribution list. Uses the information in the List-Unsubscribe header. Message senders can use mailing lists in a user-friendly way by including an option for recipients to opt out. They can do so by specifying the List-Unsubscribe header in each message following RFC-2369. Note In particular, for the unsubscribe action to work, the sender must specify mailto: and not URL-based unsubscribe information. Setting that header would also set the unsubscribeEnabled property of the message instance to true, and the unsubscribeData property to the header data. If the unsubscribeEnabled property of a message is true, you can use the unsubscribe action to unsubscribe the user from similar future messages as managed by the message sender. A successful unsubscribe action moves the message to the Deleted Items folder. The actual exclusion of the user from future mail distribution is managed by the sender.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-unsubscribe?view=graph-rest-beta
+ operationId: user.mailFolder.message_unsubscribe
parameters:
- name: user-id
in: path
@@ -4009,35 +6704,18 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- requestBody:
- description: New navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
- required: true
responses:
2XX:
- description: Created navigation property.
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/{attachment-id}':
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/$count':
get:
tags:
- users.mailFolder
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.mailFolder.message_GetAttachment
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message_GetCount
parameters:
- name: user-id
in: path
@@ -4055,22 +6733,52 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Invoke function delta
+ description: "Get a set of messages that were added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). Using deltas allows you toincrementally maintain and synchronize a local store of a user's messages."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-beta
+ operationId: user.mailFolder.message_delta
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - name: attachment-id
+ x-ms-docs-key-type: user
+ - name: mailFolder-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: mailFolder
+ - name: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
+ - $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
@@ -4081,6 +6789,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
@@ -4093,24 +6811,41 @@ paths:
type: string
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ '@odata.deltaLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/mailFolders/{mailFolder-id}/microsoft.graph.copy':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property attachments for users
- operationId: user.mailFolder.message_DeleteAttachment
+ summary: Invoke action copy
+ description: Copy a mail folder and its contents to another mail folder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-copy?view=graph-rest-beta
+ operationId: user.mailFolder_copy
parameters:
- name: user-id
in: path
@@ -4128,45 +6863,87 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/microsoft.graph.move':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action move
+ description: Move a mail folder and its contents to another mail folder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-move?view=graph-rest-beta
+ operationId: user.mailFolder_move
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - name: attachment-id
+ x-ms-docs-key-type: user
+ - name: mailFolder-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/microsoft.graph.permanentDelete':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message.attachment_GetCount
+ summary: Invoke action permanentDelete
+ description: 'Permanently delete a mail folder and remove its items from the user''s mailbox. For more information about item retention, see Configure Deleted Item retention and Recoverable Items quotas.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-permanentdelete?view=graph-rest-beta
+ operationId: user.mailFolder_permanentDelete
parameters:
- name: user-id
in: path
@@ -4184,33 +6961,70 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/microsoft.graph.updateAllMessagesReadState':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action updateAllMessagesReadState
+ operationId: user.mailFolder_updateAllMessagesReadState
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ x-ms-docs-key-type: user
+ - name: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ isRead:
+ type: boolean
+ default: false
+ nullable: true
+ suppressReadReceipts:
+ type: boolean
+ default: false
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions':
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/operations':
get:
tags:
- users.mailFolder
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.mailFolder.message_ListExtension
+ summary: Get operations from users
+ operationId: user.mailFolder_ListOperation
parameters:
- name: user-id
in: path
@@ -4228,14 +7042,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -4273,77 +7079,24 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.mailFolderOperationCollectionResponse'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
- post:
- tags:
- - users.mailFolder
- summary: Create new navigation property to extensions for users
- operationId: user.mailFolder.message_CreateExtension
- 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: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- requestBody:
- description: New navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
- required: true
- responses:
- 2XX:
- description: Created navigation property.
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
- default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/{extension-id}':
+ '/users/{user-id}/mailFolders/{mailFolder-id}/operations/{mailFolderOperation-id}':
get:
tags:
- users.mailFolder
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.mailFolder.message_GetExtension
+ summary: Get operations from users
+ operationId: user.mailFolder_GetOperation
parameters:
- name: user-id
in: path
@@ -4361,22 +7114,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- - name: extension-id
+ - name: mailFolderOperation-id
in: path
- description: The unique identifier of extension
+ description: The unique identifier of mailFolderOperation
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: extension
+ x-ms-docs-key-type: mailFolderOperation
- name: $select
in: query
description: Select properties to be returned
@@ -4403,20 +7148,21 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.mailFolderOperation'
default:
$ref: '#/components/responses/error'
deprecated: true
x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
x-ms-docs-operation-type: operation
- patch:
+ '/users/{user-id}/mailFolders/{mailFolder-id}/operations/$count':
+ get:
tags:
- users.mailFolder
- summary: Update the navigation property extensions in users
- operationId: user.mailFolder.message_UpdateExtension
+ summary: Get the number of the resource
+ operationId: user.mailFolder.operation_GetCount
parameters:
- name: user-id
in: path
@@ -4434,49 +7180,91 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ deprecated: true
+ x-ms-deprecation:
+ removalDate: '2024-06-30'
+ date: '2024-04-29'
+ version: 2024-04/PrivatePreview:updateAllMessagesReadStateAPI
+ '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get userConfigurations from users
+ operationId: user.mailFolder_ListUserConfiguration
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - name: extension-id
+ x-ms-docs-key-type: user
+ - name: mailFolder-id
in: path
- description: The unique identifier of extension
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: extension
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
- required: true
+ x-ms-docs-key-type: mailFolder
+ - $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: Success
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/responses/microsoft.graph.userConfigurationCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
x-ms-docs-operation-type: operation
- delete:
+ '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations/{userConfiguration-id}':
+ get:
tags:
- users.mailFolder
- summary: Delete navigation property extensions for users
- operationId: user.mailFolder.message_DeleteExtension
+ summary: Get userConfigurations from users
+ operationId: user.mailFolder_GetUserConfiguration
parameters:
- name: user-id
in: path
@@ -4494,45 +7282,50 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ - name: userConfiguration-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of userConfiguration
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
+ x-ms-docs-key-type: userConfiguration
+ - name: $select
+ in: query
+ description: Select properties to be returned
+ style: form
+ explode: false
schema:
- type: string
- x-ms-docs-key-type: extension
- - name: If-Match
- in: header
- description: ETag
- style: simple
+ uniqueItems: true
+ type: array
+ items:
+ type: string
+ - name: $expand
+ in: query
+ description: Expand related entities
+ style: form
+ explode: false
schema:
- type: string
+ uniqueItems: true
+ type: array
+ items:
+ type: string
responses:
2XX:
- description: Success
+ description: Retrieved navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.userConfiguration'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/$count':
+ '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations/$count':
get:
tags:
- users.mailFolder
summary: Get the number of the resource
- operationId: user.mailFolder.message.extension_GetCount
+ operationId: user.mailFolder.userConfiguration_GetCount
parameters:
- name: user-id
in: path
@@ -4550,14 +7343,28 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder_GetCount
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
+ x-ms-docs-key-type: user
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -4565,18 +7372,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions':
+ '/users/{user-id}/mailFolders/microsoft.graph.delta()':
get:
tags:
- users.mailFolder
- summary: Get mentions from users
- description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
- operationId: user.mailFolder.message_ListMention
+ summary: Invoke function delta
+ description: "Get a set of mail folders that have been added, deleted, or removed from the user's mailbox. A delta function call for mail folders in a mailbox is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls,\nyou can query for incremental changes in the mail folders. This allows you to maintain and synchronize\na local store of a user's mail folders without having to fetch all the mail folders of that mailbox from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-delta?view=graph-rest-beta
+ operationId: user.mailFolder_delta
parameters:
- name: user-id
in: path
@@ -4586,22 +7391,91 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - $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:
+ 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:
+ title: Collection of mailFolder
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/messages':
+ get:
+ tags:
+ - users.message
+ summary: Get messages from users
+ description: The messages in a mailbox or folder. Read-only. Nullable.
+ operationId: user_ListMessage
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
+ x-ms-docs-key-type: user
+ - name: includeHiddenMessages
+ in: query
+ description: Include Hidden Messages
+ style: form
+ explode: false
schema:
type: string
- x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -4639,23 +7513,18 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.mentionCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- - users.mailFolder
- summary: Create new navigation property to mentions for users
- operationId: user.mailFolder.message_CreateMention
+ - users.message
+ summary: Create new navigation property to messages for users
+ operationId: user_CreateMessage
parameters:
- name: user-id
in: path
@@ -4665,28 +7534,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ $ref: '#/components/schemas/microsoft.graph.message'
required: true
responses:
2XX:
@@ -4694,22 +7547,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions/{mention-id}':
+ '/users/{user-id}/messages/{message-id}':
get:
tags:
- - users.mailFolder
- summary: Get mentions from users
- description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
- operationId: user.mailFolder.message_GetMention
+ - users.message
+ summary: Get messages from users
+ description: The messages in a mailbox or folder. Read-only. Nullable.
+ operationId: user_GetMessage
parameters:
- name: user-id
in: path
@@ -4719,14 +7567,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -4735,14 +7575,13 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: mention-id
- in: path
- description: The unique identifier of mention
- required: true
- style: simple
+ - name: includeHiddenMessages
+ in: query
+ description: Include Hidden Messages
+ style: form
+ explode: false
schema:
type: string
- x-ms-docs-key-type: mention
- name: $select
in: query
description: Select properties to be returned
@@ -4769,20 +7608,54 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.message
+ summary: Update the navigation property messages in users
+ operationId: user_UpdateMessage
+ 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: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
- - users.mailFolder
- summary: Delete navigation property mentions for users
- operationId: user.mailFolder.message_DeleteMention
+ - users.message
+ summary: Delete navigation property messages for users
+ operationId: user_DeleteMessage
parameters:
- name: user-id
in: path
@@ -4792,14 +7665,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -4808,14 +7673,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: mention-id
- in: path
- description: The unique identifier of mention
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mention
- name: If-Match
in: header
description: ETag
@@ -4827,18 +7684,14 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/mentions/$count':
+ '/users/{user-id}/messages/{message-id}/$value':
get:
tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message.mention_GetCount
+ - users.message
+ summary: Get media content for the navigation property messages from users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_GetMessagesContent
parameters:
- name: user-id
in: path
@@ -4848,14 +7701,39 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Retrieved media content
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ default:
+ $ref: '#/components/responses/error'
+ put:
+ tags:
+ - users.message
+ summary: Update media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_SetMessagesContent
+ 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: message-id
in: path
description: The unique identifier of message
@@ -4864,24 +7742,25 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ requestBody:
+ description: New media content.
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/$count':
- get:
+ delete:
tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message_GetCount
+ - users.message
+ summary: Delete media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_DeleteMessagesContent
parameters:
- name: user-id
in: path
@@ -4891,32 +7770,32 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ x-ms-docs-key-type: message
+ - 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'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations':
+ '/users/{user-id}/messages/{message-id}/attachments':
get:
tags:
- - users.mailFolder
- summary: Get userConfigurations from users
- operationId: user.mailFolder_ListUserConfiguration
+ - users.message
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.message_ListAttachment
parameters:
- name: user-id
in: path
@@ -4926,14 +7805,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
+ x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -4971,24 +7850,59 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.userConfigurationCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations/{userConfiguration-id}':
+ post:
+ tags:
+ - users.message
+ summary: Create new navigation property to attachments for users
+ operationId: user.message_CreateAttachment
+ 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: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/messages/{message-id}/attachments/{attachment-id}':
get:
tags:
- - users.mailFolder
- summary: Get userConfigurations from users
- operationId: user.mailFolder_GetUserConfiguration
+ - users.message
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.message_GetAttachment
parameters:
- name: user-id
in: path
@@ -4998,22 +7912,22 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - name: userConfiguration-id
+ x-ms-docs-key-type: message
+ - name: attachment-id
in: path
- description: The unique identifier of userConfiguration
+ description: The unique identifier of attachment
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: userConfiguration
+ x-ms-docs-key-type: attachment
- name: $select
in: query
description: Select properties to be returned
@@ -5040,21 +7954,58 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.userConfiguration'
+ $ref: '#/components/schemas/microsoft.graph.attachment'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/userConfigurations/$count':
+ delete:
+ tags:
+ - users.message
+ summary: Delete navigation property attachments for users
+ operationId: user.message_DeleteAttachment
+ 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: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
+ - 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
+ '/users/{user-id}/messages/{message-id}/attachments/$count':
get:
tags:
- - users.mailFolder
+ - users.message
summary: Get the number of the resource
- operationId: user.mailFolder.userConfiguration_GetCount
+ operationId: user.message.attachment_GetCount
parameters:
- name: user-id
in: path
@@ -5064,14 +8015,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
+ x-ms-docs-key-type: message
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -5079,17 +8030,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/mailFolders/$count':
- get:
- tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder_GetCount
+ '/users/{user-id}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to an Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-beta
+ operationId: user.message.attachment_createUploadSession
parameters:
- name: user-id
in: path
@@ -5099,25 +8049,43 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/messages':
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/extensions':
get:
tags:
- users.message
- summary: Get messages from users
- description: The messages in a mailbox or folder. Read-only. Nullable.
- operationId: user_ListMessage
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.message_ListExtension
parameters:
- name: user-id
in: path
@@ -5127,13 +8095,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: includeHiddenMessages
- in: query
- description: Include Hidden Messages
- style: form
- explode: false
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
type: string
+ x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -5171,14 +8140,9 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -5186,8 +8150,8 @@ paths:
post:
tags:
- users.message
- summary: Create new navigation property to messages for users
- operationId: user_CreateMessage
+ summary: Create new navigation property to extensions for users
+ operationId: user.message_CreateExtension
parameters:
- name: user-id
in: path
@@ -5197,12 +8161,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.extension'
required: true
responses:
2XX:
@@ -5210,22 +8182,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}':
+ '/users/{user-id}/messages/{message-id}/extensions/{extension-id}':
get:
tags:
- users.message
- summary: Get messages from users
- description: The messages in a mailbox or folder. Read-only. Nullable.
- operationId: user_GetMessage
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.message_GetExtension
parameters:
- name: user-id
in: path
@@ -5243,13 +8210,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: includeHiddenMessages
- in: query
- description: Include Hidden Messages
- style: form
- explode: false
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
schema:
type: string
+ x-ms-docs-key-type: extension
- name: $select
in: query
description: Select properties to be returned
@@ -5276,20 +8244,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
patch:
tags:
- users.message
- summary: Update the navigation property messages in users
- operationId: user_UpdateMessage
+ summary: Update the navigation property extensions in users
+ operationId: user.message_UpdateExtension
parameters:
- name: user-id
in: path
@@ -5307,12 +8270,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.extension'
required: true
responses:
2XX:
@@ -5320,61 +8291,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
- users.message
- summary: Delete navigation property messages for users
- operationId: user_DeleteMessage
- 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: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/$value':
- get:
- tags:
- - users.message
- summary: Get media content for the navigation property messages from users
- description: The unique identifier for an entity. Read-only.
- operationId: user_GetMessagesContent
+ summary: Delete navigation property extensions for users
+ operationId: user.message_DeleteExtension
parameters:
- name: user-id
in: path
@@ -5392,68 +8317,32 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- responses:
- 2XX:
- description: Retrieved media content
- content:
- application/octet-stream:
- schema:
- type: string
- format: binary
- default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- put:
- tags:
- - users.message
- summary: Update media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user_SetMessagesContent
- parameters:
- - name: user-id
+ - name: extension-id
in: path
- description: The unique identifier of user
+ description: The unique identifier of extension
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: user
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
+ x-ms-docs-key-type: extension
+ - name: If-Match
+ in: header
+ description: ETag
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- requestBody:
- description: New media content.
- content:
- application/octet-stream:
- schema:
- type: string
- format: binary
- required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- delete:
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/messages/{message-id}/extensions/$count':
+ get:
tags:
- users.message
- summary: Delete media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user_DeleteMessagesContent
+ summary: Get the number of the resource
+ operationId: user.message.extension_GetCount
parameters:
- name: user-id
in: path
@@ -5471,29 +8360,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - 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'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/messages/{message-id}/attachments':
+ '/users/{user-id}/messages/{message-id}/mentions':
get:
tags:
- users.message
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.message_ListAttachment
+ summary: Get mentions from users
+ description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
+ operationId: user.message_ListMention
parameters:
- name: user-id
in: path
@@ -5548,14 +8428,9 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.mentionCollectionResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
@@ -5563,8 +8438,8 @@ paths:
post:
tags:
- users.message
- summary: Create new navigation property to attachments for users
- operationId: user.message_CreateAttachment
+ summary: Create new navigation property to mentions for users
+ operationId: user.message_CreateMention
parameters:
- name: user-id
in: path
@@ -5587,7 +8462,7 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.mention'
required: true
responses:
2XX:
@@ -5595,22 +8470,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.mention'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/attachments/{attachment-id}':
+ '/users/{user-id}/messages/{message-id}/mentions/{mention-id}':
get:
tags:
- users.message
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.message_GetAttachment
+ summary: Get mentions from users
+ description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
+ operationId: user.message_GetMention
parameters:
- name: user-id
in: path
@@ -5628,14 +8498,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: attachment-id
+ - name: mention-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of mention
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: mention
- name: $select
in: query
description: Select properties to be returned
@@ -5662,20 +8532,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.mention'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
delete:
tags:
- - users.message
- summary: Delete navigation property attachments for users
- operationId: user.message_DeleteAttachment
+ - users.message
+ summary: Delete navigation property mentions for users
+ operationId: user.message_DeleteMention
parameters:
- name: user-id
in: path
@@ -5693,14 +8558,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: attachment-id
+ - name: mention-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of mention
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: mention
- name: If-Match
in: header
description: ETag
@@ -5712,18 +8577,13 @@ paths:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/attachments/$count':
+ '/users/{user-id}/messages/{message-id}/mentions/$count':
get:
tags:
- users.message
summary: Get the number of the resource
- operationId: user.message.attachment_GetCount
+ operationId: user.message.mention_GetCount
parameters:
- name: user-id
in: path
@@ -5748,18 +8608,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/messages/{message-id}/extensions':
- get:
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.copy':
+ post:
tags:
- users.message
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.message_ListExtension
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-beta
+ operationId: user.message_copy
parameters:
- name: user-id
in: path
@@ -5777,60 +8635,38 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createForward':
post:
tags:
- users.message
- summary: Create new navigation property to extensions for users
- operationId: user.message_CreateExtension
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-beta
+ operationId: user.message_createForward
parameters:
- name: user-id
in: path
@@ -5849,34 +8685,44 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/extensions/{extension-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createReply':
+ post:
tags:
- users.message
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.message_GetExtension
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-beta
+ operationId: user.message_createReply
parameters:
- name: user-id
in: path
@@ -5894,54 +8740,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
- - 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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
tags:
- users.message
- summary: Update the navigation property extensions in users
- operationId: user.message_UpdateExtension
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft message later. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-beta
+ operationId: user.message_createReplyAll
parameters:
- name: user-id
in: path
@@ -5959,20 +8792,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -5980,20 +8813,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.forward':
+ post:
tags:
- users.message
- summary: Delete navigation property extensions for users
- operationId: user.message_DeleteExtension
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-beta
+ operationId: user.message_forward
parameters:
- name: user-id
in: path
@@ -6011,37 +8844,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/extensions/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.markAsJunk':
+ post:
tags:
- users.message
- summary: Get the number of the resource
- operationId: user.message.extension_GetCount
+ summary: Invoke action markAsJunk
+ description: 'Mark a message as junk. This API adds the sender to the list of blocked senders and moves the message to the Junk Email folder, when moveToJunk is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasjunk?view=graph-rest-beta
+ operationId: user.message_markAsJunk
parameters:
- name: user-id
in: path
@@ -6059,25 +8896,39 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ MoveToJunk:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- '/users/{user-id}/messages/{message-id}/mentions':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.markAsNotJunk':
+ post:
tags:
- users.message
- summary: Get mentions from users
- description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
- operationId: user.message_ListMention
+ summary: Invoke action markAsNotJunk
+ description: 'Mark a message as not junk. This API removes the sender from the list of blocked senders and moves the message to the Inbox folder, when moveToInbox is true.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-markasnotjunk?view=graph-rest-beta
+ operationId: user.message_markAsNotJunk
parameters:
- name: user-id
in: path
@@ -6095,60 +8946,39 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ MoveToInbox:
+ type: boolean
+ default: false
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.mentionCollectionResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
- $ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.move':
post:
tags:
- users.message
- summary: Create new navigation property to mentions for users
- operationId: user.message_CreateMention
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-beta
+ operationId: user.message_move
parameters:
- name: user-id
in: path
@@ -6167,34 +8997,37 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/mentions/{mention-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.permanentDelete':
+ post:
tags:
- users.message
- summary: Get mentions from users
- description: 'A collection of mentions in the message, ordered by the createdDateTime from the newest to the oldest. By default, a GET /messages does not return this property unless you apply $expand on the property.'
- operationId: user.message_GetMention
+ summary: Invoke action permanentDelete
+ description: 'Permanently delete a message and place it in the Purges folder in the dumpster in the user''s mailbox. Email clients such as Outlook or Outlook on the web can''t access permanently deleted items. Unless there''s a hold set on the mailbox, the items are permanently deleted after a set period of time. For more information about item retention, see Configure Deleted Item retention and Recoverable Items quotas.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-permanentdelete?view=graph-rest-beta
+ operationId: user.message_permanentDelete
parameters:
- name: user-id
in: path
@@ -6212,54 +9045,70 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: mention-id
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.reply':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-beta
+ operationId: user.message_reply
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of mention
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mention
- - 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
+ x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.mention'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
tags:
- users.message
- summary: Delete navigation property mentions for users
- operationId: user.message_DeleteMention
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-beta
+ operationId: user.message_replyAll
parameters:
- name: user-id
in: path
@@ -6277,37 +9126,70 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: mention-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.send':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-beta
+ operationId: user.message_send
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of mention
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mention
- - name: If-Match
- in: header
- description: ETag
+ x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
style: simple
schema:
type: string
+ x-ms-docs-key-type: message
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/mentions/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.unsubscribe':
+ post:
tags:
- users.message
- summary: Get the number of the resource
- operationId: user.message.mention_GetCount
+ summary: Invoke action unsubscribe
+ description: 'Submits an email request on behalf of the signed-in user to unsubscribe from an email distribution list. Uses the information in the List-Unsubscribe header. Message senders can use mailing lists in a user-friendly way by including an option for recipients to opt out. They can do so by specifying the List-Unsubscribe header in each message following RFC-2369. Note In particular, for the unsubscribe action to work, the sender must specify mailto: and not URL-based unsubscribe information. Setting that header would also set the unsubscribeEnabled property of the message instance to true, and the unsubscribeData property to the header data. If the unsubscribeEnabled property of a message is true, you can use the unsubscribe action to unsubscribe the user from similar future messages as managed by the message sender. A successful unsubscribe action moves the message to the Deleted Items folder. The actual exclusion of the user from future mail distribution is managed by the sender.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-unsubscribe?view=graph-rest-beta
+ operationId: user.message_unsubscribe
parameters:
- name: user-id
in: path
@@ -6325,18 +9207,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ x-ms-docs-operation-type: action
'/users/{user-id}/messages/$count':
get:
tags:
@@ -6359,11 +9235,94 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- deprecated: true
- x-ms-deprecation:
- removalDate: '2025-07-02'
- date: '2024-07-02'
- version: 2024-07/PrivatePreview:copilotExportAPI
+ '/users/{user-id}/messages/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.message
+ summary: Invoke function delta
+ description: "Get a set of messages that were added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). Using deltas allows you toincrementally maintain and synchronize a local store of a user's messages."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-beta
+ operationId: user.message_delta
+ 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: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
+ - $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:
+ 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:
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
components:
schemas:
microsoft.graph.inferenceClassification:
@@ -6401,7 +9360,7 @@ components:
childFolderCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of immediate child mailFolders in the current mailFolder.
format: int32
nullable: true
@@ -6420,14 +9379,14 @@ components:
totalItemCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of items in the mailFolder.
format: int32
nullable: true
unreadItemCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of items in the mailFolder marked as unread.
format: int32
nullable: true
@@ -6459,6 +9418,11 @@ components:
$ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty'
description: The collection of multi-value extended properties defined for the mailFolder. Read-only. Nullable.
x-ms-navigationProperty: true
+ operations:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolderOperation'
+ x-ms-navigationProperty: true
singleValueExtendedProperties:
type: array
items:
@@ -6503,7 +9467,7 @@ components:
sequence:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: 'Indicates the order in which the rule is executed, among other rules.'
format: int32
nullable: true
@@ -6685,11 +9649,62 @@ components:
size:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The length of the attachment in bytes.
format: int32
additionalProperties:
type: object
+ microsoft.graph.attachmentItem:
+ title: attachmentItem
+ type: object
+ properties:
+ attachmentType:
+ $ref: '#/components/schemas/microsoft.graph.attachmentType'
+ contentId:
+ type: string
+ description: The CID or Content-Id of the attachment for referencing in case of in-line attachments using 
tag in HTML messages. Optional.
+ nullable: true
+ contentType:
+ type: string
+ description: The nature of the data in the attachment. Optional.
+ nullable: true
+ isInline:
+ type: boolean
+ description: 'true if the attachment is an inline attachment; otherwise, false. Optional.'
+ nullable: true
+ name:
+ type: string
+ description: The display name of the attachment. This can be a descriptive string and doesn't have to be the actual file name. Required.
+ nullable: true
+ size:
+ type: number
+ description: The length of the attachment in bytes. Required.
+ format: int64
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.uploadSession:
+ title: uploadSession
+ type: object
+ properties:
+ 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 in UTC that the upload session expires. The complete file must be uploaded before this expiration time is reached.
+ format: date-time
+ nullable: true
+ nextExpectedRanges:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: 'When uploading files to document libraries, this property is a collection of byte ranges that the server is missing for the file. These ranges are zero-indexed and of the format, ''{start}-{end}'' (for example ''0-26'' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value ''{start}'', the location in the file where the next upload should begin.'
+ uploadUrl:
+ type: string
+ description: The URL endpoint that accepts PUT requests for byte ranges of the file.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -6737,6 +9752,27 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.recipient:
+ title: recipient
+ type: object
+ properties:
+ emailAddress:
+ $ref: '#/components/schemas/microsoft.graph.emailAddress'
+ additionalProperties:
+ type: object
+ microsoft.graph.mailFolderOperation:
+ allOf:
+ - $ref: '#/components/schemas/microsoft.graph.entity'
+ - title: mailFolderOperation
+ type: object
+ properties:
+ resourceLocation:
+ type: string
+ nullable: true
+ status:
+ $ref: '#/components/schemas/microsoft.graph.mailFolderOperationStatus'
+ additionalProperties:
+ type: object
microsoft.graph.userConfiguration:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -7021,14 +10057,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.recipient:
- title: recipient
- type: object
- properties:
- emailAddress:
- $ref: '#/components/schemas/microsoft.graph.emailAddress'
- additionalProperties:
- type: object
microsoft.graph.itemBody:
title: itemBody
type: object
@@ -7086,6 +10114,22 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.attachmentType:
+ title: attachmentType
+ enum:
+ - file
+ - item
+ - reference
+ type: string
+ microsoft.graph.mailFolderOperationStatus:
+ title: mailFolderOperationStatus
+ enum:
+ - notStarted
+ - running
+ - succeeded
+ - failed
+ - unknownFutureValue
+ type: string
microsoft.graph.ODataErrors.ODataError:
required:
- error
@@ -7189,6 +10233,19 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.mailFolderOperationCollectionResponse:
+ title: Collection of mailFolderOperation
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolderOperation'
+ '@odata.nextLink':
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.userConfigurationCollectionResponse:
title: Collection of userConfiguration
type: object
@@ -7232,14 +10289,14 @@ components:
maximumSize:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The maximum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
format: int32
nullable: true
minimumSize:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The minimum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
format: int32
nullable: true
@@ -7368,6 +10425,12 @@ components:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.mentionCollectionResponse'
+ microsoft.graph.mailFolderOperationCollectionResponse:
+ description: Retrieved collection
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolderOperationCollectionResponse'
microsoft.graph.userConfigurationCollectionResponse:
description: Retrieved collection
content:
@@ -7427,4 +10490,4 @@ components:
tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
scopes: { }
security:
- - azureaadv2: [ ]
\ No newline at end of file
+ - azureaadv2: [ ]
diff --git a/openApiDocs/beta/Users.Actions.yml b/openApiDocs/beta/Users.Actions.yml
index b5eaf0f35f..b0dadd1b41 100644
--- a/openApiDocs/beta/Users.Actions.yml
+++ b/openApiDocs/beta/Users.Actions.yml
@@ -10284,7 +10284,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.chatMessage'
- description: A collection of all the messages in the channel. A navigation property. Nullable.
+ description: A collection of all the messages in the channel. Nullable.
x-ms-navigationProperty: true
sharedWithTeams:
type: array
@@ -10296,7 +10296,7 @@ components:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.teamsTab'
- description: A collection of all the tabs in the channel. A navigation property.
+ description: A collection of all the tabs in the channel.
x-ms-navigationProperty: true
additionalProperties:
type: object
@@ -14295,11 +14295,11 @@ components:
properties:
displayName:
type: string
- description: 'The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don''t show up as changed when using delta.'
+ description: The display name of the identity. This property is read-only.
nullable: true
id:
type: string
- description: 'Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that''s subject to review.'
+ description: The identifier of the identity. This property is read-only.
nullable: true
additionalProperties:
type: object
diff --git a/openApiDocs/v1.0/Mail.yml b/openApiDocs/v1.0/Mail.yml
index c7f8aecd67..8733986c27 100644
--- a/openApiDocs/v1.0/Mail.yml
+++ b/openApiDocs/v1.0/Mail.yml
@@ -1934,6 +1934,71 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message.attachment_createUploadSession
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
'/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/extensions':
get:
tags:
@@ -2318,12 +2383,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/$count':
- get:
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.copy':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.childFolder.message_GetCount
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_copy
parameters:
- name: user-id
in: path
@@ -2349,50 +2418,46 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
- responses:
- 2XX:
- $ref: '#/components/responses/ODataCountResponse'
- default:
- $ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/$count':
- get:
- tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.childFolder_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: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createForward':
+ post:
tags:
- users.mailFolder
- summary: Get messageRules from users
- description: The collection of rules that apply to the user's Inbox folder.
- operationId: user.mailFolder_ListMessageRule
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_createForward
parameters:
- name: user-id
in: path
@@ -2410,96 +2475,61 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $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.messageRuleCollectionResponse'
- default:
- $ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
- post:
- tags:
- - users.mailFolder
- summary: Create new navigation property to messageRules for users
- operationId: user.mailFolder_CreateMessageRule
- parameters:
- - name: user-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of user
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: user
- - name: mailFolder-id
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReply':
+ post:
tags:
- users.mailFolder
- summary: Get messageRules from users
- description: The collection of rules that apply to the user's Inbox folder.
- operationId: user.mailFolder_GetMessageRule
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_createReply
parameters:
- name: user-id
in: path
@@ -2517,49 +2547,57 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
- - 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
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
tags:
- users.mailFolder
- summary: Update the navigation property messageRules in users
- operationId: user.mailFolder_UpdateMessageRule
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_createReplyAll
parameters:
- name: user-id
in: path
@@ -2577,20 +2615,36 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -2598,15 +2652,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.messageRule'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.forward':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property messageRules for users
- operationId: user.mailFolder_DeleteMessageRule
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_forward
parameters:
- name: user-id
in: path
@@ -2624,32 +2683,1929 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: messageRule-id
+ - name: mailFolder-id1
in: path
- description: The unique identifier of messageRule
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: messageRule
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.move':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_move
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.reply':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to an existing message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_reply
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_replyAll
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/{message-id}/microsoft.graph.send':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_send
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.childFolder.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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/messages/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Invoke function delta
+ description: "Get a set of messages that have been added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). This allows you to maintain and synchronize a local store of a user's messages without\nhaving to fetch the entire set of messages from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder.message_delta
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
+ - $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:
+ 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:
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.copy':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action copy
+ description: Copy a mailfolder and its contents to another mailfolder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-copy?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder_copy
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/{mailFolder-id1}/microsoft.graph.move':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action move
+ description: Move a mailfolder and its contents to another mailfolder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-move?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder_move
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: mailFolder-id1
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.childFolder_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/childFolders/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Invoke function delta
+ description: "Get a set of mail folders that have been added, deleted, or removed from the user's mailbox. A delta function call for mail folders in a mailbox is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls,\nyou can query for incremental changes in the mail folders. This allows you to maintain and synchronize\na local store of a user's mail folders without having to fetch all the mail folders of that mailbox from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-delta?view=graph-rest-1.0
+ operationId: user.mailFolder.childFolder_delta
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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:
+ 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:
+ title: Collection of mailFolder
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messageRules from users
+ description: The collection of rules that apply to the user's Inbox folder.
+ operationId: user.mailFolder_ListMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.messageRuleCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to messageRules for users
+ operationId: user.mailFolder_CreateMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/{messageRule-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messageRules from users
+ description: The collection of rules that apply to the user's Inbox folder.
+ operationId: user.mailFolder_GetMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ - 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.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property messageRules in users
+ operationId: user.mailFolder_UpdateMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.messageRule'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property messageRules for users
+ operationId: user.mailFolder_DeleteMessageRule
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: messageRule-id
+ in: path
+ description: The unique identifier of messageRule
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: messageRule
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.messageRule_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messages from users
+ description: The collection of messages in the mailFolder.
+ operationId: user.mailFolder_ListMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - $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.messageCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to messages for users
+ operationId: user.mailFolder_CreateMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get messages from users
+ description: The collection of messages in the mailFolder.
+ operationId: user.mailFolder_GetMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - 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.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property messages in users
+ operationId: user.mailFolder_UpdateMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property messages for users
+ operationId: user.mailFolder_DeleteMessage
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/$value':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get media content for the navigation property messages from users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_GetMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ responses:
+ 2XX:
+ description: Retrieved media content
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ default:
+ $ref: '#/components/responses/error'
+ put:
+ tags:
+ - users.mailFolder
+ summary: Update media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_SetMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New media content.
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user.mailFolder_DeleteMessagesContent
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: If-Match
+ in: header
+ description: ETag
+ style: simple
+ schema:
+ type: string
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.mailFolder.message_ListAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $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.attachmentCollectionResponse'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ x-ms-docs-operation-type: operation
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to attachments for users
+ operationId: user.mailFolder.message_CreateAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.attachment'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/{attachment-id}':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.mailFolder.message_GetAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
+ - 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.attachment'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property attachments for users
+ operationId: user.mailFolder.message_DeleteAttachment
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
+ - 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
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message.attachment_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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-1.0
+ operationId: user.mailFolder.message.attachment_createUploadSession
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.mailFolder.message_ListExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - $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.extensionCollectionResponse'
default:
$ref: '#/components/responses/error'
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messageRules/$count':
+ post:
+ tags:
+ - users.mailFolder
+ summary: Create new navigation property to extensions for users
+ operationId: user.mailFolder.message_CreateExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New navigation property
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ required: true
+ responses:
+ 2XX:
+ description: Created navigation property.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/{extension-id}':
get:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.messageRule_GetCount
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.mailFolder.message_GetExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ - 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.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.mailFolder
+ summary: Update the navigation property extensions in users
+ operationId: user.mailFolder.message_UpdateExtension
+ 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: mailFolder-id
+ in: path
+ description: The unique identifier of mailFolder
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ delete:
+ tags:
+ - users.mailFolder
+ summary: Delete navigation property extensions for users
+ operationId: user.mailFolder.message_DeleteExtension
parameters:
- name: user-id
in: path
@@ -2667,20 +4623,40 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ - 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'
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages':
+ x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/$count':
get:
tags:
- users.mailFolder
- summary: Get messages from users
- description: The collection of messages in the mailFolder.
- operationId: user.mailFolder_ListMessage
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message.extension_GetCount
parameters:
- name: user-id
in: path
@@ -2698,55 +4674,31 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/top'
- - $ref: '#/components/parameters/skip'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
- $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.messageCollectionResponse'
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.copy':
post:
tags:
- users.mailFolder
- summary: Create new navigation property to messages for users
- operationId: user.mailFolder_CreateMessage
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-1.0
+ operationId: user.mailFolder.message_copy
parameters:
- name: user-id
in: path
@@ -2764,30 +4716,46 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createForward':
+ post:
tags:
- users.mailFolder
- summary: Get messages from users
- description: The collection of messages in the mailFolder.
- operationId: user.mailFolder_GetMessage
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0
+ operationId: user.mailFolder.message_createForward
parameters:
- name: user-id
in: path
@@ -2813,41 +4781,45 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - 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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createReply':
+ post:
tags:
- users.mailFolder
- summary: Update the navigation property messages in users
- operationId: user.mailFolder_UpdateMessage
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-1.0
+ operationId: user.mailFolder.message_createReply
parameters:
- name: user-id
in: path
@@ -2874,11 +4846,19 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -2889,12 +4869,17 @@ paths:
$ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property messages for users
- operationId: user.mailFolder_DeleteMessage
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-1.0
+ operationId: user.mailFolder.message_createReplyAll
parameters:
- name: user-id
in: path
@@ -2920,25 +4905,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/$value':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.forward':
+ post:
tags:
- users.mailFolder
- summary: Get media content for the navigation property messages from users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_GetMessagesContent
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-1.0
+ operationId: user.mailFolder.message_forward
parameters:
- name: user-id
in: path
@@ -2964,22 +4965,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved media content
- content:
- application/octet-stream:
- schema:
- type: string
- format: binary
+ description: Success
default:
$ref: '#/components/responses/error'
- put:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.move':
+ post:
tags:
- users.mailFolder
- summary: Update media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_SetMessagesContent
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-1.0
+ operationId: user.mailFolder.message_move
parameters:
- name: user-id
in: path
@@ -3006,24 +5026,37 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New media content.
+ description: Action parameters
content:
- application/octet-stream:
+ application/json:
schema:
- type: string
- format: binary
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.reply':
+ post:
tags:
- users.mailFolder
- summary: Delete media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user.mailFolder_DeleteMessagesContent
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to an existing message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-1.0
+ operationId: user.mailFolder.message_reply
parameters:
- name: user-id
in: path
@@ -3049,24 +5082,37 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
tags:
- users.mailFolder
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.mailFolder.message_ListAttachment
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-1.0
+ operationId: user.mailFolder.message_replyAll
parameters:
- name: user-id
in: path
@@ -3092,55 +5138,37 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/microsoft.graph.send':
post:
tags:
- users.mailFolder
- summary: Create new navigation property to attachments for users
- operationId: user.mailFolder.message_CreateAttachment
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-1.0
+ operationId: user.mailFolder.message_send
parameters:
- name: user-id
in: path
@@ -3166,30 +5194,18 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- requestBody:
- description: New navigation property
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
- required: true
responses:
2XX:
- description: Created navigation property.
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ description: Success
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/{attachment-id}':
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/$count':
get:
tags:
- users.mailFolder
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.mailFolder.message_GetAttachment
+ summary: Get the number of the resource
+ operationId: user.mailFolder.message_GetCount
parameters:
- name: user-id
in: path
@@ -3207,22 +5223,52 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
+ responses:
+ 2XX:
+ $ref: '#/components/responses/ODataCountResponse'
+ default:
+ $ref: '#/components/responses/error'
+ '/users/{user-id}/mailFolders/{mailFolder-id}/messages/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Invoke function delta
+ description: "Get a set of messages that have been added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). This allows you to maintain and synchronize a local store of a user's messages without\nhaving to fetch the entire set of messages from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-1.0
+ operationId: user.mailFolder.message_delta
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
- - name: attachment-id
+ x-ms-docs-key-type: user
+ - name: mailFolder-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of mailFolder
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: mailFolder
+ - name: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
+ - $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
@@ -3233,6 +5279,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
@@ -3245,19 +5301,41 @@ paths:
type: string
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@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}/mailFolders/{mailFolder-id}/microsoft.graph.copy':
+ post:
tags:
- users.mailFolder
- summary: Delete navigation property attachments for users
- operationId: user.mailFolder.message_DeleteAttachment
+ summary: Invoke action copy
+ description: Copy a mailfolder and its contents to another mailfolder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-copy?view=graph-rest-1.0
+ operationId: user.mailFolder_copy
parameters:
- name: user-id
in: path
@@ -3275,40 +5353,38 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- - name: attachment-id
- in: path
- description: The unique identifier of attachment
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: attachment
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/attachments/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/{mailFolder-id}/microsoft.graph.move':
+ post:
tags:
- users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message.attachment_GetCount
+ summary: Invoke action move
+ description: Move a mailfolder and its contents to another mailfolder.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-move?view=graph-rest-1.0
+ operationId: user.mailFolder_move
parameters:
- name: user-id
in: path
@@ -3326,14 +5402,43 @@ paths:
schema:
type: string
x-ms-docs-key-type: mailFolder
- - name: message-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/mailFolders/$count':
+ get:
+ tags:
+ - users.mailFolder
+ summary: Get the number of the resource
+ operationId: user.mailFolder_GetCount
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of message
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: message
+ x-ms-docs-key-type: user
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
@@ -3341,13 +5446,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions':
+ '/users/{user-id}/mailFolders/microsoft.graph.delta()':
get:
tags:
- users.mailFolder
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.mailFolder.message_ListExtension
+ summary: Invoke function delta
+ description: "Get a set of mail folders that have been added, deleted, or removed from the user's mailbox. A delta function call for mail folders in a mailbox is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls,\nyou can query for incremental changes in the mail folders. This allows you to maintain and synchronize\na local store of a user's mail folders without having to fetch all the mail folders of that mailbox from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/mailfolder-delta?view=graph-rest-1.0
+ operationId: user.mailFolder_delta
parameters:
- name: user-id
in: path
@@ -3357,22 +5465,91 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - $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:
+ 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:
+ title: Collection of mailFolder
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.mailFolder'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
+ '/users/{user-id}/messages':
+ get:
+ tags:
+ - users.message
+ summary: Get messages from users
+ description: The messages in a mailbox or folder. Read-only. Nullable.
+ operationId: user_ListMessage
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
+ x-ms-docs-key-type: user
+ - name: includeHiddenMessages
+ in: query
+ description: Include Hidden Messages
+ style: form
+ explode: false
schema:
type: string
- x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -3410,7 +5587,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -3419,9 +5596,9 @@ paths:
x-ms-docs-operation-type: operation
post:
tags:
- - users.mailFolder
- summary: Create new navigation property to extensions for users
- operationId: user.mailFolder.message_CreateExtension
+ - users.message
+ summary: Create new navigation property to messages for users
+ operationId: user_CreateMessage
parameters:
- name: user-id
in: path
@@ -3431,28 +5608,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- - name: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
required: true
responses:
2XX:
@@ -3460,17 +5621,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/{extension-id}':
+ '/users/{user-id}/messages/{message-id}':
get:
tags:
- - users.mailFolder
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.mailFolder.message_GetExtension
+ - users.message
+ summary: Get messages from users
+ description: The messages in a mailbox or folder. Read-only. Nullable.
+ operationId: user_GetMessage
parameters:
- name: user-id
in: path
@@ -3480,14 +5641,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -3496,14 +5649,13 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
+ - name: includeHiddenMessages
+ in: query
+ description: Include Hidden Messages
+ style: form
+ explode: false
schema:
type: string
- x-ms-docs-key-type: extension
- name: $select
in: query
description: Select properties to be returned
@@ -3530,15 +5682,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- - users.mailFolder
- summary: Update the navigation property extensions in users
- operationId: user.mailFolder.message_UpdateExtension
+ - users.message
+ summary: Update the navigation property messages in users
+ operationId: user_UpdateMessage
parameters:
- name: user-id
in: path
@@ -3548,14 +5700,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -3564,20 +5708,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
requestBody:
description: New navigation property values
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
required: true
responses:
2XX:
@@ -3585,15 +5721,15 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- - users.mailFolder
- summary: Delete navigation property extensions for users
- operationId: user.mailFolder.message_DeleteExtension
+ - users.message
+ summary: Delete navigation property messages for users
+ operationId: user_DeleteMessage
parameters:
- name: user-id
in: path
@@ -3603,14 +5739,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -3619,14 +5747,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
- name: If-Match
in: header
description: ETag
@@ -3639,12 +5759,13 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/{message-id}/extensions/$count':
+ '/users/{user-id}/messages/{message-id}/$value':
get:
tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message.extension_GetCount
+ - users.message
+ summary: Get media content for the navigation property messages from users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_GetMessagesContent
parameters:
- name: user-id
in: path
@@ -3654,14 +5775,6 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
- in: path
- description: The unique identifier of mailFolder
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: mailFolder
- name: message-id
in: path
description: The unique identifier of message
@@ -3670,19 +5783,22 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Retrieved media content
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/{mailFolder-id}/messages/$count':
- get:
+ put:
tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder.message_GetCount
+ - users.message
+ summary: Update media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_SetMessagesContent
parameters:
- name: user-id
in: path
@@ -3692,27 +5808,33 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: mailFolder-id
+ - name: message-id
in: path
- description: The unique identifier of mailFolder
+ description: The unique identifier of message
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: mailFolder
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ x-ms-docs-key-type: message
+ requestBody:
+ description: New media content.
+ content:
+ application/octet-stream:
+ schema:
+ type: string
+ format: binary
+ required: true
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/mailFolders/$count':
- get:
+ delete:
tags:
- - users.mailFolder
- summary: Get the number of the resource
- operationId: user.mailFolder_GetCount
+ - users.message
+ summary: Delete media content for the navigation property messages in users
+ description: The unique identifier for an entity. Read-only.
+ operationId: user_DeleteMessagesContent
parameters:
- name: user-id
in: path
@@ -3722,20 +5844,32 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - 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'
- '/users/{user-id}/messages':
+ '/users/{user-id}/messages/{message-id}/attachments':
get:
tags:
- users.message
- summary: Get messages from users
- description: The messages in a mailbox or folder. Read-only. Nullable.
- operationId: user_ListMessage
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.message_ListAttachment
parameters:
- name: user-id
in: path
@@ -3745,13 +5879,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
- - name: includeHiddenMessages
- in: query
- description: Include Hidden Messages
- style: form
- explode: false
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
type: string
+ x-ms-docs-key-type: message
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
@@ -3789,7 +5924,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.messageCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -3799,8 +5934,8 @@ paths:
post:
tags:
- users.message
- summary: Create new navigation property to messages for users
- operationId: user_CreateMessage
+ summary: Create new navigation property to attachments for users
+ operationId: user.message_CreateAttachment
parameters:
- name: user-id
in: path
@@ -3810,12 +5945,20 @@ paths:
schema:
type: string
x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
description: New navigation property
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.attachment'
required: true
responses:
2XX:
@@ -3823,17 +5966,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.message'
+ $ref: '#/components/schemas/microsoft.graph.attachment'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}':
+ '/users/{user-id}/messages/{message-id}/attachments/{attachment-id}':
get:
tags:
- users.message
- summary: Get messages from users
- description: The messages in a mailbox or folder. Read-only. Nullable.
- operationId: user_GetMessage
+ summary: Get attachments from users
+ description: The fileAttachment and itemAttachment attachments for the message.
+ operationId: user.message_GetAttachment
parameters:
- name: user-id
in: path
@@ -3851,13 +5994,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: includeHiddenMessages
- in: query
- description: Include Hidden Messages
- style: form
- explode: false
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
schema:
type: string
+ x-ms-docs-key-type: attachment
- name: $select
in: query
description: Select properties to be returned
@@ -3871,67 +6015,28 @@ paths:
- 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.message'
- default:
- $ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
- tags:
- - users.message
- summary: Update the navigation property messages in users
- operationId: user_UpdateMessage
- 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: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- requestBody:
- description: New navigation property values
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/microsoft.graph.message'
- required: true
+ 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.message'
+ $ref: '#/components/schemas/microsoft.graph.attachment'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.message
- summary: Delete navigation property messages for users
- operationId: user_DeleteMessage
+ summary: Delete navigation property attachments for users
+ operationId: user.message_DeleteAttachment
parameters:
- name: user-id
in: path
@@ -3949,6 +6054,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
+ - name: attachment-id
+ in: path
+ description: The unique identifier of attachment
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: attachment
- name: If-Match
in: header
description: ETag
@@ -3961,13 +6074,12 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/$value':
+ '/users/{user-id}/messages/{message-id}/attachments/$count':
get:
tags:
- users.message
- summary: Get media content for the navigation property messages from users
- description: The unique identifier for an entity. Read-only.
- operationId: user_GetMessagesContent
+ summary: Get the number of the resource
+ operationId: user.message.attachment_GetCount
parameters:
- name: user-id
in: path
@@ -3985,22 +6097,23 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
+ - $ref: '#/components/parameters/search'
+ - $ref: '#/components/parameters/filter'
responses:
2XX:
- description: Retrieved media content
- content:
- application/octet-stream:
- schema:
- type: string
- format: binary
+ $ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- put:
+ '/users/{user-id}/messages/{message-id}/attachments/microsoft.graph.createUploadSession':
+ post:
tags:
- users.message
- summary: Update media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user_SetMessagesContent
+ summary: Invoke action createUploadSession
+ description: 'Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that''s smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/attachment-createuploadsession?view=graph-rest-1.0
+ operationId: user.message.attachment_createUploadSession
parameters:
- name: user-id
in: path
@@ -4019,59 +6132,34 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New media content.
+ description: Action parameters
content:
- application/octet-stream:
+ application/json:
schema:
- type: string
- format: binary
+ type: object
+ properties:
+ AttachmentItem:
+ $ref: '#/components/schemas/microsoft.graph.attachmentItem'
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.uploadSession'
default:
$ref: '#/components/responses/error'
- delete:
- tags:
- - users.message
- summary: Delete media content for the navigation property messages in users
- description: The unique identifier for an entity. Read-only.
- operationId: user_DeleteMessagesContent
- 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: message-id
- in: path
- description: The unique identifier of message
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: message
- - name: If-Match
- in: header
- description: ETag
- style: simple
- schema:
- type: string
- responses:
- 2XX:
- description: Success
- default:
- $ref: '#/components/responses/error'
- '/users/{user-id}/messages/{message-id}/attachments':
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/extensions':
get:
tags:
- users.message
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.message_ListAttachment
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.message_ListExtension
parameters:
- name: user-id
in: path
@@ -4126,7 +6214,7 @@ paths:
type: string
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.attachmentCollectionResponse'
+ $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
@@ -4136,8 +6224,8 @@ paths:
post:
tags:
- users.message
- summary: Create new navigation property to attachments for users
- operationId: user.message_CreateAttachment
+ summary: Create new navigation property to extensions for users
+ operationId: user.message_CreateExtension
parameters:
- name: user-id
in: path
@@ -4160,7 +6248,7 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.extension'
required: true
responses:
2XX:
@@ -4168,17 +6256,17 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/attachments/{attachment-id}':
+ '/users/{user-id}/messages/{message-id}/extensions/{extension-id}':
get:
tags:
- users.message
- summary: Get attachments from users
- description: The fileAttachment and itemAttachment attachments for the message.
- operationId: user.message_GetAttachment
+ summary: Get extensions from users
+ description: The collection of open extensions defined for the message. Nullable.
+ operationId: user.message_GetExtension
parameters:
- name: user-id
in: path
@@ -4196,14 +6284,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: attachment-id
+ - name: extension-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of extension
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: extension
- name: $select
in: query
description: Select properties to be returned
@@ -4230,15 +6318,62 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.attachment'
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: operation
+ patch:
+ tags:
+ - users.message
+ summary: Update the navigation property extensions in users
+ operationId: user.message_UpdateExtension
+ 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: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
+ - name: extension-id
+ in: path
+ description: The unique identifier of extension
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: extension
+ requestBody:
+ description: New navigation property values
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.extension'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- users.message
- summary: Delete navigation property attachments for users
- operationId: user.message_DeleteAttachment
+ summary: Delete navigation property extensions for users
+ operationId: user.message_DeleteExtension
parameters:
- name: user-id
in: path
@@ -4256,14 +6391,14 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: attachment-id
+ - name: extension-id
in: path
- description: The unique identifier of attachment
+ description: The unique identifier of extension
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: attachment
+ x-ms-docs-key-type: extension
- name: If-Match
in: header
description: ETag
@@ -4276,12 +6411,12 @@ paths:
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/attachments/$count':
+ '/users/{user-id}/messages/{message-id}/extensions/$count':
get:
tags:
- users.message
summary: Get the number of the resource
- operationId: user.message.attachment_GetCount
+ operationId: user.message.extension_GetCount
parameters:
- name: user-id
in: path
@@ -4306,13 +6441,16 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
- '/users/{user-id}/messages/{message-id}/extensions':
- get:
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.copy':
+ post:
tags:
- users.message
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.message_ListExtension
+ summary: Invoke action copy
+ description: Copy a message to a folder within the user's mailbox.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-copy?view=graph-rest-1.0
+ operationId: user.message_copy
parameters:
- name: user-id
in: path
@@ -4330,55 +6468,94 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createForward':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action createForward
+ description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0
+ operationId: user.message_createForward
+ parameters:
+ - name: user-id
+ in: path
+ description: The unique identifier of user
+ 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: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
schema:
- uniqueItems: true
- type: array
- items:
- type: string
+ type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- $ref: '#/components/responses/microsoft.graph.extensionCollectionResponse'
+ description: Success
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-pageable:
- nextLinkName: '@odata.nextLink'
- operationName: listMore
- x-ms-docs-operation-type: operation
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createReply':
post:
tags:
- users.message
- summary: Create new navigation property to extensions for users
- operationId: user.message_CreateExtension
+ summary: Invoke action createReply
+ description: "Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreply?view=graph-rest-1.0
+ operationId: user.message_createReply
parameters:
- name: user-id
in: path
@@ -4397,29 +6574,40 @@ paths:
type: string
x-ms-docs-key-type: message
requestBody:
- description: New navigation property
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
- description: Created navigation property.
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/extensions/{extension-id}':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.createReplyAll':
+ post:
tags:
- users.message
- summary: Get extensions from users
- description: The collection of open extensions defined for the message. Nullable.
- operationId: user.message_GetExtension
+ summary: Invoke action createReplyAll
+ description: "Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties.\n- You can update the draft later to add reply content to the body or change other message properties. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-createreplyall?view=graph-rest-1.0
+ operationId: user.message_createReplyAll
parameters:
- name: user-id
in: path
@@ -4437,49 +6625,41 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
- in: path
- description: The unique identifier of extension
- required: true
- style: simple
- schema:
- type: string
- x-ms-docs-key-type: extension
- - 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
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
- description: Retrieved navigation property
+ description: Success
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- patch:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.forward':
+ post:
tags:
- users.message
- summary: Update the navigation property extensions in users
- operationId: user.message_UpdateExtension
+ summary: Invoke action forward
+ description: "Forward a message using either JSON or MIME format. When using JSON format, you can:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-forward?view=graph-rest-1.0
+ operationId: user.message_forward
parameters:
- name: user-id
in: path
@@ -4497,20 +6677,69 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ ToRecipients:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.recipient'
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.move':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action move
+ description: Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message.
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-move?view=graph-rest-1.0
+ operationId: user.message_move
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of extension
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: extension
+ x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
+ style: simple
+ schema:
+ type: string
+ x-ms-docs-key-type: message
requestBody:
- description: New navigation property values
+ description: Action parameters
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ type: object
+ properties:
+ DestinationId:
+ type: string
+ additionalProperties:
+ type: object
required: true
responses:
2XX:
@@ -4518,15 +6747,20 @@ paths:
content:
application/json:
schema:
- $ref: '#/components/schemas/microsoft.graph.extension'
+ $ref: '#/components/schemas/microsoft.graph.message'
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- delete:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.reply':
+ post:
tags:
- users.message
- summary: Delete navigation property extensions for users
- operationId: user.message_DeleteExtension
+ summary: Invoke action reply
+ description: "Reply to the sender of a message using either JSON or MIME format. When using JSON format:\n* Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n* If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to an existing message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-reply?view=graph-rest-1.0
+ operationId: user.message_reply
parameters:
- name: user-id
in: path
@@ -4544,32 +6778,85 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - name: extension-id
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
+ responses:
+ 2XX:
+ description: Success
+ default:
+ $ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.replyAll':
+ post:
+ tags:
+ - users.message
+ summary: Invoke action replyAll
+ description: "Reply to all recipients of a message using either JSON or MIME format. When using JSON format:\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\n- If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format:\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\n- Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message and send it later."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-replyall?view=graph-rest-1.0
+ operationId: user.message_replyAll
+ parameters:
+ - name: user-id
in: path
- description: The unique identifier of extension
+ description: The unique identifier of user
required: true
style: simple
schema:
type: string
- x-ms-docs-key-type: extension
- - name: If-Match
- in: header
- description: ETag
+ x-ms-docs-key-type: user
+ - name: message-id
+ in: path
+ description: The unique identifier of message
+ required: true
style: simple
schema:
type: string
+ x-ms-docs-key-type: message
+ requestBody:
+ description: Action parameters
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ Message:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ Comment:
+ type: string
+ nullable: true
+ additionalProperties:
+ type: object
+ required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
- x-ms-docs-operation-type: operation
- '/users/{user-id}/messages/{message-id}/extensions/$count':
- get:
+ x-ms-docs-operation-type: action
+ '/users/{user-id}/messages/{message-id}/microsoft.graph.send':
+ post:
tags:
- users.message
- summary: Get the number of the resource
- operationId: user.message.extension_GetCount
+ summary: Invoke action send
+ description: 'Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.'
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-send?view=graph-rest-1.0
+ operationId: user.message_send
parameters:
- name: user-id
in: path
@@ -4587,13 +6874,12 @@ paths:
schema:
type: string
x-ms-docs-key-type: message
- - $ref: '#/components/parameters/search'
- - $ref: '#/components/parameters/filter'
responses:
2XX:
- $ref: '#/components/responses/ODataCountResponse'
+ description: Success
default:
$ref: '#/components/responses/error'
+ x-ms-docs-operation-type: action
'/users/{user-id}/messages/$count':
get:
tags:
@@ -4616,6 +6902,94 @@ paths:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
+ '/users/{user-id}/messages/microsoft.graph.delta()':
+ get:
+ tags:
+ - users.message
+ summary: Invoke function delta
+ description: "Get a set of messages that have been added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately\napplying state tokens in one or more of these calls, you can [query for incremental changes in the messages in\nthat folder](/graph/delta-query-messages). This allows you to maintain and synchronize a local store of a user's messages without\nhaving to fetch the entire set of messages from the server every time."
+ externalDocs:
+ description: Find more info here
+ url: https://learn.microsoft.com/graph/api/message-delta?view=graph-rest-1.0
+ operationId: user.message_delta
+ 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: changeType
+ in: query
+ description: 'A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.'
+ style: form
+ explode: false
+ schema:
+ type: string
+ - $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:
+ 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:
+ title: Collection of message
+ type: object
+ properties:
+ value:
+ type: array
+ items:
+ $ref: '#/components/schemas/microsoft.graph.message'
+ '@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: function
+ x-ms-pageable:
+ nextLinkName: '@odata.nextLink'
+ operationName: listMore
components:
schemas:
microsoft.graph.inferenceClassification:
@@ -4653,7 +7027,7 @@ components:
childFolderCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of immediate child mailFolders in the current mailFolder.
format: int32
nullable: true
@@ -4672,14 +7046,14 @@ components:
totalItemCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of items in the mailFolder.
format: int32
nullable: true
unreadItemCount:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The number of items in the mailFolder marked as unread.
format: int32
nullable: true
@@ -4746,7 +7120,7 @@ components:
sequence:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: 'Indicates the order in which the rule is executed, among other rules.'
format: int32
nullable: true
@@ -4910,11 +7284,62 @@ components:
size:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The length of the attachment in bytes.
format: int32
additionalProperties:
type: object
+ microsoft.graph.attachmentItem:
+ title: attachmentItem
+ type: object
+ properties:
+ attachmentType:
+ $ref: '#/components/schemas/microsoft.graph.attachmentType'
+ contentId:
+ type: string
+ description: The CID or Content-Id of the attachment for referencing for the in-line attachments using the tag in HTML messages. Optional.
+ nullable: true
+ contentType:
+ type: string
+ description: The nature of the data in the attachment. Optional.
+ nullable: true
+ isInline:
+ type: boolean
+ description: 'true if the attachment is an inline attachment; otherwise, false. Optional.'
+ nullable: true
+ name:
+ type: string
+ description: The display name of the attachment. This can be a descriptive string and doesn't have to be the actual file name. Required.
+ nullable: true
+ size:
+ type: number
+ description: The length of the attachment in bytes. Required.
+ format: int64
+ nullable: true
+ additionalProperties:
+ type: object
+ microsoft.graph.uploadSession:
+ title: uploadSession
+ type: object
+ properties:
+ 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 in UTC that the upload session will expire. The complete file must be uploaded before this expiration time is reached.
+ format: date-time
+ nullable: true
+ nextExpectedRanges:
+ type: array
+ items:
+ type: string
+ nullable: true
+ description: 'A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format ''start-end'' (for example ''0-26'' to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value ''{start}'', the location in the file where the next upload should begin.'
+ uploadUrl:
+ type: string
+ description: The URL endpoint that accepts PUT requests for byte ranges of the file.
+ nullable: true
+ additionalProperties:
+ type: object
microsoft.graph.extension:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
@@ -4922,6 +7347,14 @@ components:
type: object
additionalProperties:
type: object
+ microsoft.graph.recipient:
+ title: recipient
+ type: object
+ properties:
+ emailAddress:
+ $ref: '#/components/schemas/microsoft.graph.emailAddress'
+ additionalProperties:
+ type: object
microsoft.graph.entity:
title: entity
type: object
@@ -5194,14 +7627,6 @@ components:
nullable: true
additionalProperties:
type: object
- microsoft.graph.recipient:
- title: recipient
- type: object
- properties:
- emailAddress:
- $ref: '#/components/schemas/microsoft.graph.emailAddress'
- additionalProperties:
- type: object
microsoft.graph.itemBody:
title: itemBody
type: object
@@ -5249,6 +7674,13 @@ components:
nullable: true
additionalProperties:
type: object
+ microsoft.graph.attachmentType:
+ title: attachmentType
+ enum:
+ - file
+ - item
+ - reference
+ type: string
microsoft.graph.ODataErrors.ODataError:
required:
- error
@@ -5369,14 +7801,14 @@ components:
maximumSize:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The maximum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
format: int32
nullable: true
minimumSize:
maximum: 2147483647
minimum: -2147483648
- type: integer
+ type: number
description: The minimum size (in kilobytes) that an incoming message must have in order for a condition or exception to apply.
format: int32
nullable: true
@@ -5552,4 +7984,4 @@ components:
tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
scopes: { }
security:
- - azureaadv2: [ ]
\ No newline at end of file
+ - azureaadv2: [ ]
diff --git a/src/Mail/Mail.md b/src/Mail/Mail.md
index ec70a3020d..5b426ba603 100644
--- a/src/Mail/Mail.md
+++ b/src/Mail/Mail.md
@@ -23,4 +23,16 @@ directive:
verb: Get
subject: ^UserMailFolderMessageContent$
remove: true
+ - where:
+ verb: Invoke
+ subject: ^(Reply)(UserMessage|UserMailFolderMessage|UserMailFolderChildFolderMessage)$
+ variant: ^Reply1$|^ReplyExpanded1$|^ReplyViaIdentity1$|^ReplyViaIdentityExpanded1$
+ set:
+ subject: $1All$2
+ - where:
+ verb: New
+ subject: ^(User)(Message|MailFolderMessage|MailFolderChildFolderMessage)(Reply)$
+ variant: ^Create1$|^CreateExpanded1$|^CreateViaIdentity1$|^CreateViaIdentityExpanded1$
+ set:
+ subject: $1$2$3All
```