attachment resource type

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

You can add related content to a user event, message, Outlook task, or group post in the form of an attachment.

Events in group calendars do not support attachments.

Outlook tasks do not support reference attachments.

attachment is the base resource for the following derived types of attachments:

Note: There is a limit to the size of the file or item attachment you can add to under 4 MB.

However, if you're attaching to a message a file that is between 3MB and 150MB, you can create an upload session and iteratively upload ranges of the file to attach it. See attach large files to Outlook messages for an example.

Methods

The following methods apply to any of the derived types of attachments (fileAttachment, itemAttachment, or referenceAttachment).

Method Return Type Description
Get attachment attachment Read the properties, relationships, or raw contents of an attachment, attached to a user event, message, Outlook task, or post.
Add attachment to a user event attachment Add a file, item, or link attachment to an event in a user calendar.
Add attachment to a message attachment Add a file, item, or link attachment to a message. This operation limits the size of the attachment you can add to under 4 MB.
Create session to attach large file uploadSession Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified message. The file size must be between 3MB and 150MB.
Add attachment to an Outlook task attachment Add a file or item attachment to an Outlook task.
Add attachment to a post attachment Add a file, item, or link attachment to a group post.
List attachments of a user event attachment collection Get a list of attachments for an event in a user calendar.
List attachments of a message attachment collection Get a list of attachments for a message.
List attachments of an Outlook task attachment collection Get a list of attachments for an Outlook task.
List attachments of a post attachment collection Get a list of attachments for a post.
Delete None Delete an attachment on an event, message, Outlook task, or post.

Properties

The following are the base properties of any attachment resource. Refer to the specific type of attachment (fileAttachment, itemAttachment, or referenceAttachment) for additional properties.

Property Type Description
contentType String The MIME type.
id String Read-only.
isInline Boolean true if the attachment is an inline attachment; otherwise, false.
lastModifiedDateTime DateTimeOffset The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
name String The display name of the attachment. This does not need to be the actual file name.
size Int32 The length of the attachment in bytes.

Relationships

None

JSON representation

Here is a JSON representation of the resource

{
  "contentType": "string",
  "id": "string (identifier)",
  "isInline": true,
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "size": 1024
}