timeOff resource type
Namespace: microsoft.graph
Represents a unit of nonwork in a schedule.
Inherits from changeTrackedEntity.
Methods
| Method | Return Type | Description |
|---|---|---|
| List | timeOff collection | Get the list of timeOff objects in this schedule. |
| Create | timeOff | Create a new timeOff object. |
| Get | timeOff | Get a timeOff object by ID. |
| Replace | timeOff | Replace a timeOff object. |
| Delete | None | Delete a timeOff object from the schedule. |
| Stage for deletion | None | Stage the deletion of a timeOff in a schedule in draft mode. |
Properties
| Name | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The timestamp at which this timeOff was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from changeTrackedEntity. |
| draftTimeOff | timeOffItem | The draft version of this timeOff item that is viewable by managers. It must be shared before it's visible to team members. Required. |
| id | String | ID of the timeOff. Inherited from changeTrackedEntity. |
| isStagedForDeletion | Boolean | The timeOff is marked for deletion, a process that is finalized when the schedule is shared. |
| lastModifiedBy | identitySet | The identity that last updated this timeOff. Inherited from changeTrackedEntity. |
| lastModifiedDateTime | DateTimeOffset | The timestamp at which this timeOff was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from changeTrackedEntity. |
| sharedTimeOff | timeOffItem | The shared version of this timeOff that is viewable by both employees and managers. Updates to the sharedTimeOff property send notifications to users in the Teams client. Required. |
| userId | String | ID of the user assigned to the timeOff. Required. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.timeOff",
"createdDateTime": "String (timestamp)",
"draftTimeOff": {"@odata.type": "microsoft.graph.timeOffItem"},
"id": "String (identifier)",
"isStagedForDeletion": "Boolean",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"sharedTimeOff": {"@odata.type": "microsoft.graph.timeOffItem"},
"userId": "String"
}