replaceShift

Replace an existing shift in a Microsoft Teams schedule via PUT request.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill replaceshift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: replaceShift
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/replace-shift
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill replaceshift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows for the modification or complete replacement of existing shift entries within a Microsoft Teams schedule, ensuring accurate and up-to-date workforce planning.

Core Features & Use Cases

  • Shift Replacement: Update all details of an existing shift, including user assignment, start/end times, display name, theme, and notes.
  • Schedule Management: Essential for dynamic schedule adjustments, correcting errors, or reassigning shifts.
  • Use Case: A manager needs to change the start time and assigned user for an upcoming shift due to an employee's unavailability. This Skill can be used to update the shift details directly.

Quick Start

Replace the shift with ID 'shift-001' in team 'e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c' with new details.

Frequently Asked Questions about replaceShift

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an existing shift in a Microsoft Teams schedule?

To update an existing shift in a Microsoft Teams schedule, you need the specific team ID and shift ID, then provide a JSON payload containing the modified shift details via a PUT request. This replaces the previous shift properties.

What shift properties can I modify when updating a Microsoft Teams schedule?

When updating a Microsoft Teams schedule shift, you can modify user assignments, scheduling groups, and shared shift details. Shared details include the display name, start and end times, theme, and notes.

What information is required to replace a shift in Microsoft Teams?

Replacing a shift in Microsoft Teams requires the target team ID, the specific shift ID, and a JSON payload. The JSON payload must contain the updated shift information, including new scheduling group and user assignment details.

Can I reassign a shift to a different user in Microsoft Teams?

Yes, you can reassign a shift to a different user in Microsoft Teams by updating the user assignment property. You include the new user assignment within the JSON payload sent to the specified team and shift IDs.

Does updating a Teams schedule shift completely overwrite the previous details?

Yes, updating a Teams schedule shift uses a PUT request which completely replaces the existing shift entry. You must include all desired shift properties in the JSON payload to avoid losing shared shift details.