skills/create-time-off-reason/SKILL.md
# Create Time Off Reason Creates a new time off reason for a team's schedule. Time off reasons define the categories of time off available to team members. ## API Details - **API**: Microsoft Teams API - **Method**: POST - **Path**: `/teams/{team-id}/schedule/timeOffReasons` - **Operation ID**: `createTimeOffReason` - **Tag**: TimeOff - **OpenAPI**: [microsoft-teams-openapi.yaml](../../openapi/microsoft-teams-openapi.yaml) ## Sandbox Mock server URL: `http://localhost:8080/rest/microsoft-te
npx skillsauth add naftiko/microsoft-teams-sandbox skills/create-time-off-reasonInstall 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.
Creates a new time off reason for a team's schedule. Time off reasons define the categories of time off available to team members.
/teams/{team-id}/schedule/timeOffReasonscreateTimeOffReasonMock server URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/{team-id}/schedule/timeOffReasons
Authorization: Bearer {access-token}Content-Type: application/json| Name | In | Type | Required | Description |
|---|---|---|---|---|
| team-id | path | string | Yes | The unique identifier of the team |
| Field | Type | Required | Description |
|---|---|---|---|
| displayName | string | Yes | The display name of the time off reason |
| iconType | string | No | The icon type for the reason (e.g., plane, firstAid, car) |
| isActive | boolean | No | Whether the time off reason is active |
{
"displayName": "Vacation",
"iconType": "plane",
"isActive": true
}
curl -s -X POST \
"http://localhost:8080/rest/microsoft-teams-api/1.0.0/teams/e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c/schedule/timeOffReasons" \
-H "Authorization: Bearer {access-token}" \
-H "Content-Type: application/json" \
-d '{
"displayName": "Vacation",
"iconType": "plane",
"isActive": true
}'
{
"id": "reason-001",
"displayName": "Vacation",
"iconType": "plane",
"isActive": true,
"createdDateTime": "2025-01-01T00:00:00Z",
"lastModifiedDateTime": "2025-01-01T00:00:00Z"
}
When the user wants to create a new time off reason for a team's schedule, use this operation. Provide the team ID as a path parameter and include the display name, icon type, and active status in the request body. The response returns the created time off reason with a 201 status code.
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}`