Edit

ItemActivity resource type

  • Article

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.

The ItemActivity resource provides information about activities that took place on an item or within a container. Currently only available on SharePoint and OneDrive for Business.

JSON representation

{
  "id": "string (identifier)",
  "access": "microsoft.graph.accessAction",
  "action": {"@odata.type": "microsoft.graph.itemActionSet"},
  "actor": {"@odata.type": "microsoft.graph.identitySet"},
  "driveItem": {"@odata.type": "microsoft.graph.driveItem"},
  "listItem": {"@odata.type": "microsoft.graph.listItem"},
  "location": {"@odata.type": "microsoft.graph.location"},
  "times": {"@odata.type": "microsoft.graph.itemActivityTimeSet"}
}

Properties

Property Type Description
id string The unique identifier of the activity. Read-only.
access accessAction An item was accessed.
action itemActionSet Details about the action that took place. Read-only.
actor identitySet Identity of who performed the action. Read-only.
location location Physical location where the action was performed. Read-only.
times itemActivityTimeSet Details about when the activity took place. Read-only.

Relationships

Relationship Type Description
driveItem driveItem Exposes the driveItem that was the target of this activity.
listItem listItem Exposes the listItem that was the target of this activity.

Actions

The actions that took place within an activity are detailed in the action property. Below are the actions that are available today. New actions may get logged in the future, so make sure your app is tolerant of handling an itemActivity without any actions that your app understands.

Action name Type Description
comment commentAction A comment was added to the item.
create createAction An item was created.
delete deleteAction An item was deleted.
edit editAction An item was edited.
mention mentionAction A user was mentioned in the item.
move moveAction An item was moved.
rename renameAction An item was renamed.
restore restoreAction An item was restored.
share shareAction An item was shared.
version versionAction An item was versioned.

Remarks

ItemActivity is currently only available on SharePoint and OneDrive for Business.