skills.rest
naftiko
naftikoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

List Time Off Reasons

Retrieve time off reasons from a Microsoft Teams schedule via API.

Updated Feb 19, 2026
Search Tags:#list#teams#schedule#time off#reasons
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-time-off-reasons
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: List Time Off Reasons
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/list-time-off-reasons
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-time-off-reasons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users understand and manage the available time off categories configured within a Microsoft Teams schedule.

Core Features & Use Cases

  • View Time Off Categories: Retrieves a list of all predefined time off reasons (e.g., Vacation, Sick Leave).
  • Inform Scheduling: Provides users with the exact names and types of reasons they can use when requesting or logging time off.
  • Use Case: A manager needs to approve a time off request and wants to ensure the employee uses a valid, configured reason. They use this Skill to see the available options.

Quick Start

List all available time off reasons for the team with ID 'e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c'.

Frequently Asked Questions about List Time Off Reasons

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

FAQPage Schema
How do I list time off reasons configured for a Microsoft Teams schedule?▼

To list time off reasons for a Microsoft Teams schedule, you need the team ID and an authorization token to call the API endpoint, which returns a collection of reason resources with display names and icon types.

What information is included when retrieving time off reasons from a Teams schedule?▼

Retrieving time off reasons from a Teams schedule returns a collection of resources detailing the specific display names and icon types configured for each predefined category, such as Vacation or Sick Leave.

Do I need a team ID to view available time off categories in Microsoft Teams?▼

Yes, you need a specific Microsoft Teams team ID and an authorization token to retrieve and view the configured time off reasons via the schedule API endpoint.

How can managers verify valid time off reasons before approving requests in Teams?▼

Managers can verify valid time off reasons by retrieving the configured schedule categories, ensuring employees use exact display names and valid icon types when logging or requesting time off.

Can I create new time off reasons using this Microsoft Teams schedule API?▼

No, this retrieves a collection of existing time off reason resources configured for a specific Microsoft Teams schedule, providing display names and icon types rather than creating new categories.

Related Skills

Explore More Product & Management Skills→
naftikonaftiko

Delete Time Off Entry

Delete a specific time off entry from a Microsoft Teams schedule.

Official
Basic
naftikonaftiko

Create Time Off Reason

Create a time off reason in a Microsoft Teams schedule with display name, icon, and active status.

Official
Basic
naftikonaftiko

Get Shift

Retrieve shift details from Microsoft Teams schedules using team and shift IDs.

Official
Basic
naftikonaftiko

Create Time Off Entry

Create time off entries via POST requests to the Microsoft Teams API.

Official
Basic