Microsoft 365 · Schema
microsoft.graph.schedule
ProductivityCollaborationEmailCalendarFileIdentityMicrosoftMicrosoft Graph
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The unique identifier for an entity. Read-only. |
| enabled | booleannull | Indicates whether the schedule is enabled for the team. Required. |
| isActivitiesIncludedWhenCopyingShiftsEnabled | booleannull | Indicates whether copied shifts include activities from the original shift. |
| offerShiftRequestsEnabled | booleannull | Indicates whether offer shift requests are enabled for the schedule. |
| openShiftsEnabled | booleannull | Indicates whether open shifts are enabled for the schedule. |
| provisionStatus | object | |
| provisionStatusCode | stringnull | Additional information about why schedule provisioning failed. |
| startDayOfWeek | object | |
| swapShiftsRequestsEnabled | booleannull | Indicates whether swap shifts requests are enabled for the schedule. |
| timeClockEnabled | booleannull | Indicates whether time clock is enabled for the schedule. |
| timeClockSettings | object | |
| timeOffRequestsEnabled | booleannull | Indicates whether time off requests are enabled for the schedule. |
| timeZone | stringnull | The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required. |
| workforceIntegrationIds | array | The IDs for the workforce integrations associated with this schedule. |
| dayNotes | array | The day notes in the schedule. |
| offerShiftRequests | array | The offer requests for shifts in the schedule. |
| openShiftChangeRequests | array | The open shift requests in the schedule. |
| openShifts | array | The set of open shifts in a scheduling group in the schedule. |
| schedulingGroups | array | The logical grouping of users in the schedule (usually by role). |
| shifts | array | The shifts in the schedule. |
| swapShiftsChangeRequests | array | The swap requests for shifts in the schedule. |
| timeCards | array | The time cards in the schedule. |
| timeOffReasons | array | The set of reasons for a time off in the schedule. |
| timeOffRequests | array | The time off requests in the schedule. |
| timesOff | array | The instances of times off in the schedule. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/microsoft-365/json-schema/microsoft-365-microsoft-graph-schedule-schema.json",
"title": "microsoft.graph.schedule",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/microsoft-365-teams-api-openapi.yml#/components/schemas/microsoft.graph.schedule",
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.entity"
},
{
"title": "schedule",
"type": "object",
"properties": {
"enabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether the schedule is enabled for the team. Required."
},
"isActivitiesIncludedWhenCopyingShiftsEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether copied shifts include activities from the original shift."
},
"offerShiftRequestsEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether offer shift requests are enabled for the schedule."
},
"openShiftsEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether open shifts are enabled for the schedule."
},
"provisionStatus": {
"$ref": "#/$defs/microsoft.graph.operationStatus"
},
"provisionStatusCode": {
"type": [
"string",
"null"
],
"description": "Additional information about why schedule provisioning failed.",
"readOnly": true
},
"startDayOfWeek": {
"$ref": "#/$defs/microsoft.graph.dayOfWeek"
},
"swapShiftsRequestsEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether swap shifts requests are enabled for the schedule."
},
"timeClockEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether time clock is enabled for the schedule."
},
"timeClockSettings": {
"$ref": "#/$defs/microsoft.graph.timeClockSettings"
},
"timeOffRequestsEnabled": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether time off requests are enabled for the schedule."
},
"timeZone": {
"type": [
"string",
"null"
],
"description": "The time zone of the schedule team as an IANA time zone database (tz database) name; for example, America/Chicago. For the full list of valid values, see List of tz database time zones. Required."
},
"workforceIntegrationIds": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "The IDs for the workforce integrations associated with this schedule."
},
"dayNotes": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.dayNote"
},
"description": "The day notes in the schedule.",
"x-ms-navigationProperty": true
},
"offerShiftRequests": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.offerShiftRequest"
},
"description": "The offer requests for shifts in the schedule.",
"x-ms-navigationProperty": true
},
"openShiftChangeRequests": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.openShiftChangeRequest"
},
"description": "The open shift requests in the schedule.",
"x-ms-navigationProperty": true
},
"openShifts": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.openShift"
},
"description": "The set of open shifts in a scheduling group in the schedule.",
"x-ms-navigationProperty": true
},
"schedulingGroups": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.schedulingGroup"
},
"description": "The logical grouping of users in the schedule (usually by role).",
"x-ms-navigationProperty": true
},
"shifts": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.shift"
},
"description": "The shifts in the schedule.",
"x-ms-navigationProperty": true
},
"swapShiftsChangeRequests": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.swapShiftsChangeRequest"
},
"description": "The swap requests for shifts in the schedule.",
"x-ms-navigationProperty": true
},
"timeCards": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeCard"
},
"description": "The time cards in the schedule.",
"x-ms-navigationProperty": true
},
"timeOffReasons": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeOffReason"
},
"description": "The set of reasons for a time off in the schedule.",
"x-ms-navigationProperty": true
},
"timeOffRequests": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeOffRequest"
},
"description": "The time off requests in the schedule.",
"x-ms-navigationProperty": true
},
"timesOff": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeOff"
},
"description": "The instances of times off in the schedule.",
"x-ms-navigationProperty": true
}
},
"additionalProperties": {
"type": "object"
}
}
],
"$defs": {
"microsoft.graph.bodyType": {
"title": "bodyType",
"enum": [
"text",
"html"
],
"type": "string"
},
"microsoft.graph.changeTrackedEntity": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.entity"
},
{
"title": "changeTrackedEntity",
"type": "object",
"properties": {
"createdBy": {
"$ref": "#/$defs/microsoft.graph.identitySet"
},
"createdDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "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",
"format": "date-time",
"readOnly": true
},
"lastModifiedBy": {
"$ref": "#/$defs/microsoft.graph.identitySet"
},
"lastModifiedDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "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",
"format": "date-time",
"readOnly": true
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.confirmedBy": {
"title": "confirmedBy",
"enum": [
"none",
"user",
"manager",
"unknownFutureValue"
],
"type": "string",
"x-ms-enum-flags": {
"isFlags": true
}
},
"microsoft.graph.dayNote": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "dayNote",
"type": "object",
"properties": {
"dayNoteDate": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$",
"type": [
"string",
"null"
],
"description": "The date of the day note.",
"format": "date"
},
"draftDayNote": {
"$ref": "#/$defs/microsoft.graph.itemBody"
},
"sharedDayNote": {
"$ref": "#/$defs/microsoft.graph.itemBody"
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.dayOfWeek": {
"title": "dayOfWeek",
"enum": [
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
],
"type": "string"
},
"microsoft.graph.entity": {
"title": "entity",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The unique identifier for an entity. Read-only."
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.geoCoordinates": {
"title": "geoCoordinates",
"type": "object",
"properties": {
"altitude": {
"type": [
"number",
"null"
],
"description": "Optional. The altitude (height), in feet, above sea level for the item. Read-only.",
"format": "double"
},
"latitude": {
"type": [
"number",
"null"
],
"description": "Optional. The latitude, in decimal, for the item. Read-only.",
"format": "double"
},
"longitude": {
"type": [
"number",
"null"
],
"description": "Optional. The longitude, in decimal, for the item. Read-only.",
"format": "double"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.identity": {
"title": "identity",
"type": "object",
"properties": {
"displayName": {
"type": [
"string",
"null"
],
"description": "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta."
},
"id": {
"type": [
"string",
"null"
],
"description": "Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review."
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.identitySet": {
"title": "identitySet",
"type": "object",
"properties": {
"application": {
"$ref": "#/$defs/microsoft.graph.identity"
},
"device": {
"$ref": "#/$defs/microsoft.graph.identity"
},
"user": {
"$ref": "#/$defs/microsoft.graph.identity"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.itemBody": {
"title": "itemBody",
"type": "object",
"properties": {
"content": {
"type": [
"string",
"null"
],
"description": "The content of the item."
},
"contentType": {
"$ref": "#/$defs/microsoft.graph.bodyType"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.offerShiftRequest": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.scheduleChangeRequest"
},
{
"title": "offerShiftRequest",
"type": "object",
"properties": {
"recipientActionDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "The date and time when the recipient approved or declined the request.",
"format": "date-time",
"readOnly": true
},
"recipientActionMessage": {
"type": [
"string",
"null"
],
"description": "The message sent by the recipient regarding the request."
},
"recipientUserId": {
"type": [
"string",
"null"
],
"description": "The recipient's user ID."
},
"senderShiftId": {
"type": [
"string",
"null"
],
"description": "The sender's shift ID."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.openShift": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "openShift",
"type": "object",
"properties": {
"draftOpenShift": {
"$ref": "#/$defs/microsoft.graph.openShiftItem"
},
"isStagedForDeletion": {
"type": [
"boolean",
"null"
],
"description": "The openShift is marked for deletion, a process that is finalized when the schedule is shared."
},
"schedulingGroupId": {
"type": [
"string",
"null"
],
"description": "The ID of the schedulingGroup that contains the openShift."
},
"sharedOpenShift": {
"$ref": "#/$defs/microsoft.graph.openShiftItem"
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.openShiftChangeRequest": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.scheduleChangeRequest"
},
{
"title": "openShiftChangeRequest",
"type": "object",
"properties": {
"openShiftId": {
"type": [
"string",
"null"
],
"description": "ID for the open shift."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.openShiftItem": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.shiftItem"
},
{
"title": "openShiftItem",
"type": "object",
"properties": {
"openSlotCount": {
"maximum": 2147483647,
"minimum": -2147483648,
"type": "number",
"description": "Count of the number of slots for the given open shift.",
"format": "int32"
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.operationStatus": {
"title": "operationStatus",
"enum": [
"NotStarted",
"Running",
"Completed",
"Failed"
],
"type": "string"
},
"microsoft.graph.scheduleChangeRequest": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "scheduleChangeRequest",
"type": "object",
"properties": {
"assignedTo": {
"$ref": "#/$defs/microsoft.graph.scheduleChangeRequestActor"
},
"managerActionDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "The date and time when the manager approved or declined the scheduleChangeRequest. 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.",
"format": "date-time",
"readOnly": true
},
"managerActionMessage": {
"type": [
"string",
"null"
],
"description": "The message sent by the manager regarding the scheduleChangeRequest. Optional."
},
"managerUserId": {
"type": [
"string",
"null"
],
"description": "The user ID of the manager who approved or declined the scheduleChangeRequest.",
"readOnly": true
},
"senderDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "The date and time when the sender sent the scheduleChangeRequest. 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.",
"format": "date-time",
"readOnly": true
},
"senderMessage": {
"type": [
"string",
"null"
],
"description": "The message sent by the sender of the scheduleChangeRequest. Optional."
},
"senderUserId": {
"type": [
"string",
"null"
],
"description": "The user ID of the sender of the scheduleChangeRequest.",
"readOnly": true
},
"state": {
"$ref": "#/$defs/microsoft.graph.scheduleChangeState"
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.scheduleChangeRequestActor": {
"title": "scheduleChangeRequestActor",
"enum": [
"sender",
"recipient",
"manager",
"system",
"unknownFutureValue"
],
"type": "string"
},
"microsoft.graph.scheduleChangeState": {
"title": "scheduleChangeState",
"enum": [
"pending",
"approved",
"declined",
"unknownFutureValue"
],
"type": "string"
},
"microsoft.graph.scheduleEntity": {
"title": "scheduleEntity",
"type": "object",
"properties": {
"endDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"format": "date-time"
},
"startDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"format": "date-time"
},
"theme": {
"$ref": "#/$defs/microsoft.graph.scheduleEntityTheme"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.scheduleEntityTheme": {
"title": "scheduleEntityTheme",
"enum": [
"white",
"blue",
"green",
"purple",
"pink",
"yellow",
"gray",
"darkBlue",
"darkGreen",
"darkPurple",
"darkPink",
"darkYellow",
"unknownFutureValue",
"darkRed",
"cranberry",
"darkOrange",
"bronze",
"peach",
"gold",
"lime",
"forest",
"lightGreen",
"jade",
"lightTeal",
"darkTeal",
"steel",
"skyBlue",
"blueGray",
"lavender",
"lilac",
"plum",
"magenta",
"darkBrown",
"beige",
"charcoal",
"silver"
],
"type": "string"
},
"microsoft.graph.schedulingGroup": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "schedulingGroup",
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "The code for the schedulingGroup to represent an external identifier. This field must be unique within the team in Microsoft Teams and uses an alphanumeric format, with a maximum of 100 characters."
},
"displayName": {
"type": [
"string",
"null"
],
"description": "The display name for the schedulingGroup. Required."
},
"isActive": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether the schedulingGroup can be used when creating new entities or updating existing ones. Required.",
"readOnly": true
},
"userIds": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "The list of user IDs that are a member of the schedulingGroup. Required."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.shift": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "shift",
"type": "object",
"properties": {
"draftShift": {
"$ref": "#/$defs/microsoft.graph.shiftItem"
},
"isStagedForDeletion": {
"type": [
"boolean",
"null"
],
"description": "The shift is marked for deletion, a process that is finalized when the schedule is shared."
},
"schedulingGroupId": {
"type": [
"string",
"null"
],
"description": "ID of the scheduling group the shift is part of. Required."
},
"sharedShift": {
"$ref": "#/$defs/microsoft.graph.shiftItem"
},
"userId": {
"type": [
"string",
"null"
],
"description": "ID of the user assigned to the shift. Required."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.shiftActivity": {
"title": "shiftActivity",
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
],
"description": "Customer defined code for the shiftActivity. Required."
},
"displayName": {
"type": [
"string",
"null"
],
"description": "The name of the shiftActivity. Required."
},
"endDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "The end date and time for the shiftActivity. 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. Required.",
"format": "date-time"
},
"isPaid": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether the microsoft.graph.user should be paid for the activity during their shift. Required."
},
"startDateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": [
"string",
"null"
],
"description": "The start date and time for the shiftActivity. 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. Required.",
"format": "date-time"
},
"theme": {
"$ref": "#/$defs/microsoft.graph.scheduleEntityTheme"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.shiftItem": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.scheduleEntity"
},
{
"title": "shiftItem",
"type": "object",
"properties": {
"activities": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.shiftActivity"
},
"description": "An incremental part of a shift which can cover details of when and where an employee is during their shift. For example, an assignment or a scheduled break or lunch. Required."
},
"displayName": {
"type": [
"string",
"null"
],
"description": "The shift label of the shiftItem."
},
"notes": {
"type": [
"string",
"null"
],
"description": "The shift notes for the shiftItem."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.swapShiftsChangeRequest": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.offerShiftRequest"
},
{
"title": "swapShiftsChangeRequest",
"type": "object",
"properties": {
"recipientShiftId": {
"type": [
"string",
"null"
],
"description": "The recipient's Shift ID"
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.timeCard": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "timeCard",
"type": "object",
"properties": {
"breaks": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeCardBreak"
},
"description": "The list of breaks associated with the timeCard."
},
"clockInEvent": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
},
"clockOutEvent": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
},
"confirmedBy": {
"$ref": "#/$defs/microsoft.graph.confirmedBy"
},
"notes": {
"$ref": "#/$defs/microsoft.graph.itemBody"
},
"originalEntry": {
"$ref": "#/$defs/microsoft.graph.timeCardEntry"
},
"state": {
"$ref": "#/$defs/microsoft.graph.timeCardState"
},
"userId": {
"type": [
"string",
"null"
],
"description": "User ID to which the timeCard belongs."
}
},
"additionalProperties": {
"type": "object"
}
}
]
},
"microsoft.graph.timeCardBreak": {
"title": "timeCardBreak",
"type": "object",
"properties": {
"breakId": {
"type": [
"string",
"null"
],
"description": "ID of the timeCardBreak."
},
"end": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
},
"notes": {
"$ref": "#/$defs/microsoft.graph.itemBody"
},
"start": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.timeCardEntry": {
"title": "timeCardEntry",
"type": "object",
"properties": {
"breaks": {
"type": "array",
"items": {
"$ref": "#/$defs/microsoft.graph.timeCardBreak"
},
"description": "The clock-in event of the timeCard."
},
"clockInEvent": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
},
"clockOutEvent": {
"$ref": "#/$defs/microsoft.graph.timeCardEvent"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.timeCardEvent": {
"title": "timeCardEvent",
"type": "object",
"properties": {
"dateTime": {
"pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
"type": "string",
"description": "The time the entry is recorded.",
"format": "date-time"
},
"isAtApprovedLocation": {
"type": [
"boolean",
"null"
],
"description": "Indicates whether this action happens at an approved location."
},
"notes": {
"$ref": "#/$defs/microsoft.graph.itemBody"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.timeCardState": {
"title": "timeCardState",
"enum": [
"clockedIn",
"onBreak",
"clockedOut",
"unknownFutureValue"
],
"type": "string"
},
"microsoft.graph.timeClockSettings": {
"title": "timeClockSettings",
"type": "object",
"properties": {
"approvedLocation": {
"$ref": "#/$defs/microsoft.graph.geoCoordinates"
}
},
"additionalProperties": {
"type": "object"
}
},
"microsoft.graph.timeOff": {
"allOf": [
{
"$ref": "#/$defs/microsoft.graph.changeTrackedEntity"
},
{
"title": "timeOff",
"type": "object",
"properties": {
"draftTimeOff": {
"$ref": "#/$defs/microsoft.graph.timeOffItem"
},
"isStagedForDeletion": {
"type": [
"boolean",
"null"
],
"description": "The timeOff is marked for deletion, a process that is finalized when the schedule is shared."
},
"share
# --- truncated at 32 KB (36 KB total) ---
# Full source: https://artifacts.apis.io/microsoft-365/json-schema/microsoft-365-microsoft-graph-schedule-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-365-microsoft-graph-schedule"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.