Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 type of shift request to take timeOff.
Inherits from scheduleChangeRequest.
Methods
| Method | Return type | Description |
|---|---|---|
| List | timeOffRequest collection | Get the list of timeOffRequest objects in this schedule. |
| Create | timeOffRequest | Create a timeOffRequest objects in this schedule. |
| Get | timeOffRequest | Read the properties and relationships of a timeOffRequest object. |
| Delete | None | Delete a timeOffRequest object. |
| Approve | None | Approve a timeOffRequest. |
| Approve for user | None | Approve a timeOffRequest object for a user. This action only supports application permissions. |
| Decline | None | Decline a timeOffRequest. |
| Decline for user | None | Decline a timeOffRequest object for a user. This action only supports application permissions. |
Properties
| Property | Type | Description |
|---|---|---|
| assignedTo | scheduleChangeRequestActor | Indicates who the request is assigned to. Inherited from scheduleChangeRequest.The possible values are: sender, recipient, manager, system, unknownFutureValue. |
| createdBy | identitySet | The user who created the entity. Inherited from changeTrackedEntity. |
| createdDateTime | DateTimeOffset | The date and time when the entity was created. Inherited from changeTrackedEntity. |
| endDateTime | DateTimeOffset | The date and time the time off ends in ISO 8601 format and in UTC time. |
| id | String | The unique identifier for the entity. Inherited from entity. Inherits from entity |
| lastModifiedBy | identitySet | The user who last modified the entity. Inherited from changeTrackedEntity. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the entity was last modified. Inherited from changeTrackedEntity. |
| managerActionDateTime | DateTimeOffset | The date and time when the manager approved or declined the request. Inherited from scheduleChangeRequest. |
| managerActionMessage | String | The message sent by the manager regarding the request. Inherited from scheduleChangeRequest. |
| managerUserId | String | The user ID of the manager who approved or declined the request. Inherited from scheduleChangeRequest. |
| senderDateTime | DateTimeOffset | The date and time when the sender sent the request. Inherited from scheduleChangeRequest. |
| senderMessage | String | The message sent by the sender of the request. Inherited from scheduleChangeRequest. |
| senderUserId | String | The user ID of the sender of the request. Inherited from scheduleChangeRequest. |
| startDateTime | DateTimeOffset | The date and time the time off starts in ISO 8601 format and in UTC time. |
| state | scheduleChangeState | The state of the entity. Inherited from scheduleChangeRequest.The possible values are: pending, approved, declined, unknownFutureValue. |
| timeOffReasonId | String | The reason for the time off. |
Relationships
None.
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.timeOffRequest",
"id": "String (identifier)",
"createdBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"assignedTo": "String",
"state": "String",
"senderMessage": "String",
"senderDateTime": "String (timestamp)",
"managerActionMessage": "String",
"managerActionDateTime": "String (timestamp)",
"senderUserId": "String",
"managerUserId": "String",
"startDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"timeOffReasonId": "String"
}