Get calendar temporal context

Returns a snapshot of the calendar's temporal state: current event, next event, recent events, and upcoming events within 24 hours. Designed for agents that need situational awareness of a calendar.

get/v1/calendars/{id}/context

Request

Base URL: https://api.chronary.ai
URL: https://api.chronary.ai/v1/calendars/{id}/context
Auth: HTTP bearer

Path parameters

idstring required

Calendar ID

Example:cal_01H9X4M2P5R8T6V0

Response

Calendar temporal context

calendar_idstring required

nowstring date-time required

agent_status'idle' | 'working' | 'waiting' | 'error' required

Example response

{
  "calendar_id": "cal_01H9X4M2P5R8T6V0",
  "now": "2026-04-14T10:30:00.000Z",
  "agent_status": "idle",
  "current_event": {
    "id": "evt_01H9X4M2P5R8T6V0",
    "calendarId": "cal_01H9X4M2P5R8T6V0",
    "orgId": "org_01H9X4M2P5R8T6V0",
    "title": "Team standup",
    "description": "Daily sync meeting.",
    "startTime": "2025-01-20T09:00:00.000Z",
    "endTime": "2025-01-20T09:30:00.000Z",
    "status": "confirmed",
    "source": "internal",
    "metadata": {},
    "reminders": [
      10
    ],
    "recurrenceExdates": [],
    "recurringEventId": "evt_01H9X4M2P5R8T6V0",
    "originalStartTime": "2025-01-20T09:00:00.000Z",
    "external_sync": {
      "status": "not_configured"
    },
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  },
  "next_event": {
    "id": "evt_01H9X4M2P5R8T6V0",
    "calendarId": "cal_01H9X4M2P5R8T6V0",
    "orgId": "org_01H9X4M2P5R8T6V0",
    "title": "Team standup",
    "description": "Daily sync meeting.",
    "startTime": "2025-01-20T09:00:00.000Z",
    "endTime": "2025-01-20T09:30:00.000Z",
    "status": "confirmed",
    "source": "internal",
    "metadata": {},
    "reminders": [
      10
    ],
    "recurrenceExdates": [],
    "recurringEventId": "evt_01H9X4M2P5R8T6V0",
    "originalStartTime": "2025-01-20T09:00:00.000Z",
    "external_sync": {
      "status": "not_configured"
    },
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  },
  "recent_events": [
    {
      "id": "evt_01H9X4M2P5R8T6V0",
      "calendarId": "cal_01H9X4M2P5R8T6V0",
      "orgId": "org_01H9X4M2P5R8T6V0",
      "title": "Team standup",
      "description": "Daily sync meeting.",
      "startTime": "2025-01-20T09:00:00.000Z",
      "endTime": "2025-01-20T09:30:00.000Z",
      "status": "confirmed",
      "source": "internal",
      "metadata": {},
      "reminders": [
        10
      ],
      "recurrenceExdates": [],
      "recurringEventId": "evt_01H9X4M2P5R8T6V0",
      "originalStartTime": "2025-01-20T09:00:00.000Z",
      "external_sync": {
        "status": "not_configured"
      },
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-15T10:00:00.000Z"
    }
  ],
  "upcoming": [
    {
      "id": "evt_01H9X4M2P5R8T6V0",
      "calendarId": "cal_01H9X4M2P5R8T6V0",
      "orgId": "org_01H9X4M2P5R8T6V0",
      "title": "Team standup",
      "description": "Daily sync meeting.",
      "startTime": "2025-01-20T09:00:00.000Z",
      "endTime": "2025-01-20T09:30:00.000Z",
      "status": "confirmed",
      "source": "internal",
      "metadata": {},
      "reminders": [
        10
      ],
      "recurrenceExdates": [],
      "recurringEventId": "evt_01H9X4M2P5R8T6V0",
      "originalStartTime": "2025-01-20T09:00:00.000Z",
      "external_sync": {
        "status": "not_configured"
      },
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-01-15T10:00:00.000Z"
    }
  ]
}

Changes

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