timecard 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 timecard entry in the schedule.

Methods

Method Return type Description
List timeCard collection Get the list of timecard objects in this schedule.
Create timeCard Create a new timecard object.
Get timeCard Get a timecard object by ID.
Replace None Replace a timecard object.
Delete None Delete a timecard object from the schedule.
clockIn timeCard Clock in to start a timecard.
clockOut None Clock out to end an open timecard.
startBreak None Start a timeCardBreak in a specific timecard.
endBreak None End the open timeCardBreak in a specific timecard.
confirmTimeCard None Confirm a timecard record.

Properties

Property Type Description
id string ID of the timeCard.
userId string User ID to which the timeCard belongs.
state timeCardState The current state of the timeCard during its life cycle.Possible values are: clockedIn, onBreak, clockedOut, unknownFutureValue.
clockInEvent timeCardEvent The clock-in event of the timeCard.
clockOutEvent timeCardEvent The clock-out event of the timeCard.
notes itemBody Notes about the timeCard.
breaks timeCardBreak collection The list of breaks associated with the timeCard.
originalEntry timeCardEntry The original timeCardEntry of the timeCard, before user edits.
confirmedBy confirmedBy Indicate if this timeCard entry is confirmed. Possible values are none, user, manager, unknownFutureValue.
createdDateTime Edm.dateTimeOffset The timestamp in which the timeCard was created.
createdBy IdentitySet Identity of the person who created the entity.
lastModifiedDateTime dateTimeOffset The timestamp in which the timeCard was last modified.
lastModifiedBy IdentitySet Identity of the person who last modified the entity.

JSON representation

The following is a JSON representation of the resource.

{
  "userId": "string (identifier)",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {"@odata.type":"microsoft.graph.identitySet"},
  "clockInEvent" : {"@odata.type":"microsoft.graph.timeCardEvent"},
  "clockOutEvent" : {"@odata.type":"microsoft.graph.timeCardEvent"},
  "notes" : {"@odata.type":"microsoft.graph.itemBody"},
  "breaks" : [{"@odata.type":"microsoft.graph.timeCardEvent"}],
  "originalEntry" : {"@odata.type":"microsoft.graph.timeCardEntry"}
}