Skip to content
LiveNew tools this week
Submit
AIMarketly
Replace Shift logo

Replace Shift

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

naftiko/microsoft-teams-sandbox0installs0starsOther

SKILL.md

Full skill instructions

Replace Shift

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

API Details

  • API: Microsoft Teams API
  • Method: PUT
  • Path: /​teams/​{team-id}/​schedule/​shifts/​{shift-id}
  • Operation ID: replaceShift
  • 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/shifts/{shift-id}

Required Headers

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

OAuth Scopes

  • Schedule.ReadWrite.All

Parameters

NameInTypeRequiredDescription
team-idpathstringYesThe unique identifier of the team
shift-idpathstringYesThe unique identifier of the shift

Request Body

FieldTypeRequiredDescription
userIdstringNoThe ID of the user assigned to the shift
schedulingGroupIdstringNoThe ID of the scheduling group
sharedShiftobjectNoThe shared shift details
{
  "userId": "user-001",
  "schedulingGroupId": "group-001",
  "sharedShift": {
    "displayName": "Morning Shift",
    "startDateTime": "2025-01-22T08:00:00Z",
    "endDateTime": "2025-01-22T16:00:00Z",
    "theme": "blue",
    "notes": "Regular morning shift"
  }
}

Example Request

curl -s -X PUT \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c/schedule/shifts/shift-001" \
  -H "Authorization: Bearer {access-token}" \
  -H "Content-Type: application/​json" \
  -d '{
    "userId": "user-001",
    "schedulingGroupId": "group-001",
    "sharedShift": {
      "displayName": "Morning Shift",
      "startDateTime": "2025-01-22T08:00:00Z",
      "endDateTime": "2025-01-22T16:00:00Z",
      "theme": "blue",
      "notes": "Regular morning shift"
    }
  }'

Example Response

{
  "id": "shift-001",
  "userId": "user-001",
  "schedulingGroupId": "group-001",
  "createdDateTime": "2025-01-15T08:00:00Z",
  "lastModifiedDateTime": "2025-01-15T08:00:00Z",
  "sharedShift": {
    "displayName": "Morning Shift",
    "startDateTime": "2025-01-22T08:00:00Z",
    "endDateTime": "2025-01-22T16:00:00Z",
    "theme": "blue",
    "notes": "Regular morning shift"
  }
}

Instructions

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