---
updatedAt: 2026-04-21T18:01:21.000Z
agentTools:
  projectIndex: https://docs.talkdesk.com/llms.txt
---

# Retrieve agent schedule as iCalendar

Returns the agent's schedule in iCalendar format (RFC 5545). This endpoint is publicly accessible via a unique token and does not require JWT authentication or OAuth scopes.

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Public API",
    "version": "5.12.68",
    "description": "Documents public API endpoints. Scopes are given to external software, that we don't control",
    "contact": {
      "name": "Talkdesk",
      "url": "https://talkdesk.com"
    }
  },
  "servers": [
    {
      "url": "https://api.talkdeskapp.com",
      "description": "United States (td-us-1)"
    },
    {
      "url": "https://api.talkdeskapp.eu",
      "description": "Europe (td-eu-1)"
    },
    {
      "url": "https://api.talkdeskappca.com",
      "description": "Canada (td-ca-1)"
    },
    {
      "url": "https://api.talkdeskapp.co.uk",
      "description": "United Kingdom (td-uk-1)"
    }
  ],
  "tags": [
    {
      "name": "Scheduled Time Off API",
      "description": "Scheduled Time Off API"
    }
  ],
  "paths": {
    "/wfm/aion/agents/calendar/{token}/schedule.ics": {
      "get": {
        "x-namespace": "/wfm/aion",
        "description": "Returns the agent's schedule in iCalendar format (RFC 5545). This endpoint is publicly accessible via a unique token and does not require JWT authentication or OAuth scopes.",
        "operationId": "GetAgentCalendarSchedule",
        "parameters": [
          {
            "description": "Unique token identifying the agent's calendar subscription",
            "example": "550e8400e29b41d4a716446655440000",
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "description": "UUId",
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/calendar": {
                "schema": {
                  "type": "string"
                },
                "example": "BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:-//Talkdesk//WFM Aion//EN\nBEGIN:VEVENT\nDTSTART:20260312T090000Z\nDTEND:20260312T170000Z\nSUMMARY:Shift\nEND:VEVENT\nEND:VCALENDAR\n"
              }
            },
            "description": "Agent schedule in iCalendar format"
          },
          "404": {
            "content": {
              "application/json": {
                "example": {
                  "code": "1580007",
                  "message": "Resource not found."
                },
                "schema": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "name",
                          "description"
                        ],
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            },
            "description": "Calendar not found for the given token"
          }
        },
        "security": [],
        "summary": "Retrieve agent schedule as iCalendar",
        "tags": [
          "Scheduled Time Off API"
        ]
      }
    }
  },
  "externalDocs": {
    "description": "External Documentation",
    "url": "https://api-docs.talkdeskapp.com/external_docs"
  }
}
```