Edit

taskHistoryItem 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 a record of a change made to a task within a planner plan. Use this resource to track the history of task modifications, including creation, updates, deletions, and moves.

Inherits from plannerHistoryItem.

Methods

For the list of supported methods, see plannerHistoryItem.

Properties

Property Type Description
actor identitySet The identity of the user or application that performed the change. Inherited from plannerHistoryItem.
entityId String The ID of the task that was changed. Inherited from plannerHistoryItem.
entityType historyEntityType The type of entity that was changed. The possible values are: task, unknownFutureValue. Inherited from plannerHistoryItem.
eventType historyEventType The type of change event that occurred. The possible values are: created, updated, deleted, undeleted, moved, unknownFutureValue. Inherited from plannerHistoryItem.
id String The unique identifier for the history item. Inherited from plannerHistoryItem.
newData plannerTaskData A snapshot of the task state after the change. This property is null for deletion events.
occurredDateTime DateTimeOffset The date and time when the change occurred. 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 plannerHistoryItem.
oldData plannerTaskData A snapshot of the task state before the change. This property is null for creation and undeletion events.
planId String The ID of the plan that contains the task. Inherited from plannerHistoryItem.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.taskHistoryItem",
  "id": "String (identifier)",
  "planId": "String",
  "entityId": "String",
  "entityType": "String",
  "eventType": "String",
  "occurredDateTime": "String (timestamp)",
  "actor": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "oldData": {
    "@odata.type": "microsoft.graph.plannerTaskData"
  },
  "newData": {
    "@odata.type": "microsoft.graph.plannerTaskData"
  }
}