mailboxItem resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Represents an item in a mailboxFolder. Items are Exchange mailbox items like message, task, event, contact, or note.
This resource supports delta query to track incremental additions, deletions, and updates, by providing a delta function. It also supports single-value and multi-value extended properties for filtering on custom data that isn't already exposed in the Microsoft Graph API metadata.
Inherits from outlookItem.
Methods
| Method | Return type | Description |
|---|---|---|
| List | mailboxItem collection | Get the mailboxItem collection within a specified mailboxFolder in a mailbox. |
| Get | mailboxItem | Read the properties and relationships of a mailboxItem object. |
| Get delta | mailboxItem collection | Get a set of mailboxItem objects that have been added, deleted, or updated in a specified mailboxFolder. |
| Extended properties | ||
| Get single-value property | mailboxItem | Get mailbox items that contain a single-value extended property by using $expand or $filter. |
| Get multi-value property | mailboxItem | Get a mailbox item that contains a multi-value extended property by using $expand. |
Properties
| Property | Type | Description |
|---|---|---|
| categories | String collection | The categories associated with the message. Inherited from outlookItem. |
| changeKey | String | The version of the item. Inherited from outlookItem. |
| createdDateTime | DateTimeOffset | The date and time when the item was created. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is 2021-01-01T00:00:00Z. Inherited from outlookItem. |
| id | String | The unique identifier for the item. Inherited from outlookItem. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the item was last changed. The date and time information uses ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2021 is 2021-01-01T00:00:00Z. Inherited from outlookItem. |
| size | Int64 | The length of the item in bytes. |
| type | String | The message class ID of the item. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| multiValueExtendedProperties | multiValueLegacyExtendedProperty collection | The collection of multi-value extended properties defined for the mailboxItem. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | The collection of single-value extended properties defined for the mailboxItem. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.mailboxItem",
"categories": ["String"],
"changeKey": "String",
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"size": "Int64",
"type": "String"
}