← Back to home

Calendar Subscriptions

Share your agent's calendar via iCalendar (ICS) subscriptions. Subscribers can import the URL into Google Calendar, Apple Calendar, Outlook, and more.

iCalendar Feed

GET /api/cal/:agentId/:token.ics

Returns an iCalendar feed. No auth header needed — the token in the URL acts as authentication.

Auth: Token in URL

Response:

BEGIN:VCALENDAR
PRODID:-//AgentWorkspace//Calendar//EN
METHOD:PUBLISH
...
END:VCALENDAR

How It Works

  • When you create an agent, a subscription URL is automatically generated with a unique token.
  • You can share additional subscription URLs with other email addresses from the agent's Settings tab.
  • Tokens can be rotated (new URL, old one stops working) or revoked (permanently disabled).
  • Calendar apps poll the URL periodically (typically every few hours) to sync new events.

Adding to Your Calendar App

Google Calendar

  1. Copy the subscription URL from your agent's Settings tab.
  2. Open Google Calendar in your browser.
  3. In the left sidebar, click the + next to "Other calendars".
  4. Select From URL.
  5. Paste the subscription URL and click Add calendar.
  6. Events will appear within a few minutes. Google syncs external calendars every 12–24 hours.

Note: Google Calendar rejects empty feeds. Make sure your agent has at least one event before subscribing. See Known Issues for details.

Apple Calendar (macOS / iOS)

  1. Copy the subscription URL from your agent's Settings tab.
  2. macOS: Open Calendar, go to File > New Calendar Subscription, paste the URL, click Subscribe.
  3. iOS: Go to Settings > Calendar > Accounts > Add Account > Other > Add Subscribed Calendar, paste the URL.
  4. Apple Calendar syncs subscriptions every ~15 minutes to daily, depending on your settings.

Microsoft Outlook

  1. Copy the subscription URL from your agent's Settings tab.
  2. Open Outlook Calendar in your browser.
  3. Click Add calendar > Subscribe from web.
  4. Paste the URL, give it a name, and click Import.

Managing Subscriptions

From your agent's Settings tab you can:

  • Share — grant calendar access to another email address. Each subscriber gets their own unique URL and token.
  • Rotate — generate a new token for a subscription. The old URL stops working immediately. Useful if a URL was accidentally shared.
  • Revoke — permanently disable a subscription. The subscriber's calendar app will stop receiving updates.