List Time Off Entries

Retrieve paginated time off entries from a Microsoft Teams schedule via GET request.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users easily view and manage time off entries within a Microsoft Teams schedule, streamlining absence tracking.

Core Features & Use Cases

  • List Time Off: Retrieve all time off entries for a specific team.
  • Pagination: Control the number of entries returned per page using $top.
  • Filtering: Narrow down results by user or date range with $filter.
  • Use Case: A manager needs to quickly see all planned absences for their team next month. They can use this Skill, providing the team ID and a date filter, to get a clear overview.

Quick Start

List the first 10 time off entries for the team with ID 'e1b3c5a7-9d2f-4b6e-8c1a-3f5d7e9b2a4c'.

Frequently Asked Questions about List Time Off Entries

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

FAQPage Schema
How do I list Microsoft Teams time off entries for my team schedule?▼

To list Microsoft Teams time off entries, you retrieve a paginated list from a specified team schedule using a GET request to the `/teams/{team-id}/schedule/timesOff` API endpoint. This provides a clear overview of planned absences.

Can I filter Teams schedule absences by specific users and dates?▼

Yes, you can filter Teams schedule absences by specific users and date ranges using the `$filter` query parameter. This narrows down the retrieved time off entries to match your exact scheduling requirements.

How do I control the number of time off entries returned from the Teams API?▼

You control the number of time off entries returned from the Teams API by using pagination controls. Specifically, you use the `$top` parameter to define the page size and apply pagination logic for efficient data retrieval.

Do I need a specific team ID to retrieve time off schedules from Microsoft Teams?▼

Yes, you need a specific Microsoft Teams team ID to retrieve time off schedules. The API requires this unique identifier in the endpoint path `/teams/{team-id}/schedule/timesOff` to locate and fetch the correct absence data.

What is the best way to track upcoming team absences in a Microsoft Teams schedule?▼

The best way to track upcoming team absences is to retrieve time off entries via the Teams API while applying a date range filter. This allows managers to quickly see all planned absences for their team next month.