Calendars

Create a calendar

Creates a shared (org-level) calendar not associated with any specific agent.

post/v1/calendars

Request

  • Base URL: https://api.chronary.ai
  • URL: https://api.chronary.ai/v1/calendars
  • Auth: HTTP bearer

Request body

namestring required
timezonestring required
agent_status'idle' | 'working' | 'waiting' | 'error'
default_remindersinteger[] nullable
metadataobject

Response

Calendar created

idstring required
orgIdstring required
agentIdstring nullable required
namestring required
timezonestring required
metadataobject required
externalIdstring nullable required

Provider calendar ID when bridged to an external provider (Phase 3); null otherwise.

providerstring nullable required

External provider this calendar is bridged to (google | microsoft | apple); null otherwise.

deletedAtstring date-time nullable required
createdAtstring date-time required
updatedAtstring date-time required
agent_status'idle' | 'working' | 'waiting' | 'error' required
default_remindersinteger[] nullable required

Default reminder offsets (minutes before start) inherited by events that don't set their own. null = use the system default (10 min); [] = no reminders.

ical_urlstring uri required

Example response

{
  "id": "cal_01H9X4M2P5R8T6V0",
  "orgId": "org_01H9X4M2P5R8T6V0",
  "agentId": "agt_01H9X4M2P5R8T6V0",
  "name": "Work Calendar",
  "timezone": "America/Los_Angeles",
  "metadata": {},
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-15T10:00:00.000Z",
  "agent_status": "idle",
  "default_reminders": [
    10
  ],
  "ical_url": "https://api.chronary.ai/ical/abc123def456ghi789.ics"
}

Changes

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