Skip to content
LiveNew tools this week
Submit
AIMarketly
Replace Time Off Entry logo

Replace Time Off Entry

Replaces an existing time off entry in a team's schedule with the provided data. The entire time off resource is replaced with the request body content.

naftiko/microsoft-teams-sandbox0installs0starsOther

SKILL.md

Full skill instructions

Replace Time Off Entry

Replaces an existing time off entry in a team's schedule with the provided data. The entire time off resource is replaced with the request body content.

API Details

  • API: Microsoft Teams API
  • Method: PUT
  • Path: /​teams/​{team-id}/​schedule/​timesOff/​{timeOff-id}
  • Operation ID: replaceTimeOff
  • Tag: TimeOff
  • OpenAPI: microsoft-teams-openapi.yaml

Sandbox

Mock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}/schedule/timesOff/{timeOff-id}

Required Headers

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

Parameters

NameInTypeRequiredDescription
team-idpathstringYesThe unique identifier of the team
timeOff-idpathstringYesThe unique identifier of the time off entry

Request Body

FieldTypeRequiredDescription
userIdstringNoThe ID of the user taking time off
sharedTimeOffobjectNoThe shared time off details
{
  "userId": "user-001",
  "sharedTimeOff": {
    "timeOffReasonId": "reason-001",
    "startDateTime": "2025-02-01T00:00:00Z",
    "endDateTime": "2025-02-05T00:00:00Z",
    "theme": "pink"
  }
}

Example Request

curl -s -X PUT \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c/schedule/timesOff/timeoff-001" \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/​json" \
  -d '{
    "userId": "user-001",
    "sharedTimeOff": {
      "timeOffReasonId": "reason-001",
      "startDateTime": "2025-02-01T00:00:00Z",
      "endDateTime": "2025-02-05T00:00:00Z",
      "theme": "pink"
    }
  }'

Example Response

{
  "id": "timeoff-001",
  "userId": "user-001",
  "createdDateTime": "2025-01-10T10:00:00Z",
  "lastModifiedDateTime": "2025-01-15T10:00:00Z",
  "sharedTimeOff": {
    "timeOffReasonId": "reason-001",
    "startDateTime": "2025-02-01T00:00:00Z",
    "endDateTime": "2025-02-05T00:00:00Z",
    "theme": "pink"
  }
}

Instructions

When the user wants to replace or fully update an existing time off entry in a team's schedule, use this operation. Provide both the team ID and time off ID as path parameters, along with the complete time off data in the request body. This replaces the entire time off resource.