iCal Subscriptions

Create an iCal subscription for an agent

Subscribes an agent's calendar to an external iCal feed. The feed is polled approximately every 15 minutes and events are synced into the target calendar.

post/v1/agents/{agent_id}/ical-subscriptions

Request

  • Base URL: https://api.chronary.ai
  • URL: https://api.chronary.ai/v1/agents/{agent_id}/ical-subscriptions
  • Auth: HTTP bearer

Path parameters

agent_idstring required

Agent ID

Example:agt_01H9X4M2P5R8T6V0

Request body

calendar_idstring required
urlstring uri required
labelstring

Response

Subscription created

idstring required
agent_idstring required
calendar_idstring required
urlstring uri required
labelstring nullable required
status'active' | 'error' | 'paused' required
last_synced_atstring date-time nullable required
last_errorstring nullable required
created_atstring date-time required

Example response

{
  "id": "ics_01H9X4M2P5R8T6V0",
  "agent_id": "agt_01H9X4M2P5R8T6V0",
  "calendar_id": "cal_01H9X4M2P5R8T6V0",
  "url": "https://calendar.google.com/calendar/ical/example/basic.ics",
  "label": "Google Calendar",
  "status": "active",
  "last_synced_at": "2025-01-15T10:00:00.000Z",
  "created_at": "2025-01-15T10:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.