attachment resource type

Namespace: microsoft.graph

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

Events in group calendars do not support attachments.

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

Note: If you're attaching a file to a group post, or attaching an item to an event, message, or group post, limit the size of the attachment to 3 MB.

If you're attaching a file under 3 MB, you can add the file attachment to a user event, to a message, or to a group post.

If you're attaching a file between 3 MB and 150 MB to an event or message, 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, or post.
Add attachment to a user event attachment Add a file, item, or link attachment to an event in a user calendar. This operation limits the size of the attachment you can add to under 3 MB.
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 3 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 or event. The file size must be between 3 MB and 150 MB.
Add attachment to a post attachment Add a file, item, or link attachment to a post. This operation limits the size of the attachment you can add to under 3 MB.
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 a post attachment collection Get a list of attachments for a post.
Delete None Delete an attachment on an event, message, 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 is 2014-01-01T00:00:00Z
name String The attachment's file name.
size Int32 The length of the attachment in bytes.

Relationships

None

JSON representation

The following JSON representation shows the resource type.

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