Skip to content
LiveNew tools this week
Submit
AIMarketly
Clock Out logo

Clock Out

Records a clock-out event for a specific time card in a team's schedule. Updates the time card with the clock-out timestamp and location approval status.

naftiko/microsoft-teams-sandbox0installs0starsOther

SKILL.md

Full skill instructions

Clock Out

Records a clock-out event for a specific time card in a team's schedule. Updates the time card with the clock-out timestamp and location approval status.

API Details

  • API: Microsoft Teams API
  • Method: POST
  • Path: /​teams/​{team-id}/​schedule/​timeCards/​{timeCard-id}/​clockOut
  • Operation ID: clockOut
  • Tag: Shifts
  • OpenAPI: microsoft-teams-openapi.yaml

Sandbox

Mock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}/schedule/timeCards/{timeCard-id}/clockOut

Required Headers

  • Authorization: Bearer {access-token}
  • Content-Type: application/​json

Parameters

NameInTypeRequiredDescription
team-idpathstringYesThe unique identifier of the team
timeCard-idpathstringYesThe unique identifier of the time card

Request Body

FieldTypeRequiredDescription
atApprovedLocationbooleanNoWhether the clock-out is at an approved location
notesobjectNoNotes for the clock-out event (ItemBody object with content and contentType)
{
  "atApprovedLocation": true,
  "notes": {
    "content": "Ending morning shift",
    "contentType": "text"
  }
}

Example Request

curl -s -X POST \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c/schedule/timeCards/timecard-001/clockOut" \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/​json" \
  -d '{
    "atApprovedLocation": true,
    "notes": {
      "content": "Ending morning shift",
      "contentType": "text"
    }
  }'

Example Response

{
  "id": "timecard-001",
  "userId": "user-001",
  "state": "clockedOut",
  "clockInEvent": {
    "dateTime": "2025-01-22T08:00:00Z",
    "atApprovedLocation": true
  },
  "clockOutEvent": {
    "dateTime": "2025-01-22T16:00:00Z",
    "atApprovedLocation": true
  },
  "createdDateTime": "2025-01-22T08:00:00Z",
  "lastModifiedDateTime": "2025-01-22T16:00:00Z"
}

Instructions

When the user wants to clock out or record a clock-out event for a time card, use this operation. Provide the team ID and time card ID as path parameters, along with the optional location approval status and notes in the request body. The response returns the updated time card with both clock-in and clock-out event details.