skills/get-shift/SKILL.md
# Get Shift Retrieves the details of a specific shift by its unique identifier within a team's schedule. Returns the shift resource with its properties including shared shift details. ## API Details - **API**: Microsoft Teams API - **Method**: GET - **Path**: `/teams/{team-id}/schedule/shifts/{shift-id}` - **Operation ID**: `getShift` - **Tag**: Shifts - **OpenAPI**: [microsoft-teams-openapi.yaml](../../openapi/microsoft-teams-openapi.yaml) ## Sandbox Mock server URL: `http://localhost:8080
npx skillsauth add naftiko/microsoft-teams-sandbox skills/get-shiftInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Retrieves the details of a specific shift by its unique identifier within a team's schedule. Returns the shift resource with its properties including shared shift details.
/teams/{team-id}/schedule/shifts/{shift-id}getShiftMock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}/schedule/shifts/{shift-id}
Authorization: Bearer {access-token}Schedule.Read.All| Name | In | Type | Required | Description |
|---|---|---|---|---|
| team-id | path | string | Yes | The unique identifier of the team |
| shift-id | path | string | Yes | The unique identifier of the shift |
curl -s -X GET \
"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}"
{
"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"
}
}
When the user wants to retrieve details about a specific shift in a team's schedule, use this operation. Provide both the team ID and shift ID as path parameters. The response includes the shift's assigned user, scheduling group, and shared shift details such as start and end times.
development
# Update Workforce Integration Update the properties of an existing workforce integration using the Microsoft Teams API. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: PATCH /teamwork/workforceIntegrations/{workforceIntegration-id} - **Operation ID**: updateWorkforceIntegration - **Tag**: WorkforceIntegrations ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` - **Full URL**: `
development
# Update Team Tag Update the properties of an existing tag in a Microsoft Teams team. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: PATCH /teams/{team-id}/tags/{tag-id} - **Operation ID**: updateTeamworkTag - **Tag**: Tags ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` ## Required Headers - `Authorization: Bearer {access_token}` - `Content-Type: application/json` ## OAu
development
# Update Team Updates the properties of a specific team. Only the properties included in the request body are updated. ## API Details - **API**: Microsoft Teams API - **Method**: PATCH - **Path**: `/teams/{team-id}` - **Operation ID**: `updateTeam` - **Tag**: Teams - **OpenAPI**: [microsoft-teams-openapi.yaml](../../openapi/microsoft-teams-openapi.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}` ## Required Headers - `Authorization:
development
# Update Tab Update the properties of a specific tab in a channel within a team using the Microsoft Teams API. ## API Details - **API Name**: Microsoft Teams API - **OpenAPI Ref**: `../../openapi/microsoft-teams-openapi.yaml` - **Endpoint**: `PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}` - **operationId**: `updateTab` - **Tag**: Tabs ## Sandbox - **Base URL**: `http://localhost:8080/rest/microsoft-teams-api/1.0.0` ## Required Headers - `Authorization: Bearer {access_token}`