Our review
Retrieves the list of time zones supported for the user's mailbox via the Microsoft Outlook Mail API.
Strengths
- Simple and direct API call
- Supports both Windows and IANA time zone standards
- Returns aliases and display names for easy selection
Limitations
- Requires OAuth access token with MailboxSettings.Read scope
- Only returns the list of time zones, not the user's current time zone
When you need to display available time zones for the user to choose from and set their mailbox time zone.
If you only need to set the time zone without listing options, or if the user does not have an Exchange Online mailbox.
Security analysis
SafeThe skill performs a read-only GET request to retrieve time zones, with no destructive commands, no exposure of secrets, and no use of dangerous tools.
No concerns found
Examples
List all supported time zones for my mailbox in Windows standard.Get the IANA time zones supported for my mailbox.List Supported Time Zones
List all supported time zones for the user's mailbox.
API Details
- API: Microsoft Outlook Mail API
- Method: GET
- Path:
/me/outlook/supportedTimeZones - Operation ID:
listSupportedTimeZones - Tag: LocaleAndTimeZone
- OpenAPI: microsoft-outlook-mail-api.yaml
Sandbox
Mock server URL: http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/supportedTimeZones
Required Headers
Authorization: Bearer {access-token}
OAuth Scopes
MailboxSettings.Read
Parameters
| Parameter | In | Type | Required | Description | |-----------|-----|------|----------|-------------| | TimeZoneStandard | query | string | No | The time zone standard to use: "windows" or "iana" |
Example Request
curl -X GET "http://localhost:8080/rest/microsoft-outlook-mail-api/1.0.0/me/outlook/supportedTimeZones?TimeZoneStandard=windows" \
-H "Authorization: Bearer {access-token}"
Example Response
{
"value": [
{
"alias": "Pacific Standard Time",
"displayName": "(UTC-08:00) Pacific Time (US & Canada)"
}
]
}
Instructions
Use this operation to retrieve the list of time zones supported for the user's mailbox configuration. Optionally specify the TimeZoneStandard query parameter to get time zones in either "windows" or "iana" format. This is useful when setting the user's time zone preference in mailbox settings.
Task Prioritizer
Productivity
Prioritizes your tasks using Eisenhower, ICE, and RICE frameworks.
Weekly Status Report Generator
Productivity
Generate structured and concise weekly status reports.
Daily Standup Report
Productivity
Generates structured and concise daily standup reports.