One event in full

calendar.event.get

GET/api/v1/households/{household_id}/queries/calendar.event.get

Query
Rigel runs it

The event with everything about it: times in the household's zone, how it repeats in words and as a rule, its changed and cancelled occurrences, extra dates, people, reminders, attachments, calendar and the app that owns it. Error: event_not_found.

Parameters#

One event in full: parameters
Field	Description
`household_id`pathstringrequired	The household's ID.
`event_id`querystringrequired	A calendar event ID, such as evt_01JC0000000000000000000000.

Response#

200 The answer.

One event in full: response fields
Field	Description
`event_id`stringrequired	A calendar event ID, such as evt_01JC0000000000000000000000.
`title`stringrequired	No description.
`description`string or nullrequired	No description.
`location`string or nullrequired	No description.
`kind`one of: event, appointment, activity, chore, meal, trip, birthday, holiday, reminder, busyrequired	No description.
`status`one of: confirmed, tentativerequired	No description.
`is_all_day`booleanrequired	No description.
`starts_at`string or nullrequired	ISO 8601 with the household's offset; null for all-day.
`ends_at`string or nullrequired	No description.
`start_date`string or nullrequired	No description.
`end_date`string or nullrequired	The last day, inclusive.
`time_zone`stringrequired	The zone the event repeats in.
`when`stringrequired	The first occurrence in words.
`recurrence`string or nullrequired	The repeat rule (RFC 5545), or null for a single event.
`repeats`string or nullrequired	The repeat rule in words, such as "every Saturday until Mar 28".
`exceptions`array of objectsrequired
`exceptions[].occurrence_start`stringrequired	No description.
`exceptions[].cancelled`booleanrequired	No description.
`exceptions[].title`string or nullrequired	The changed title, or null if unchanged.
`exceptions[].description`string or nullrequired	No description.
`exceptions[].location`string or nullrequired	No description.
`exceptions[].starts_at`string or nullrequired	No description.
`exceptions[].ends_at`string or nullrequired	No description.
`exceptions[].start_date`string or nullrequired	No description.
`exceptions[].end_date`string or nullrequired	No description.
`extra_dates`array of stringsrequired	Extra occurrences beyond the rule, by their start.
`people`array of objectsrequired
`people[].id`stringrequired	A person ID, such as per_01JC0000000000000000000000.
`people[].name`stringrequired	No description.
`reminders`array of objectsrequired
`reminders[].minutes_before`integerrequired	No description.
`reminders[].person`object or nullrequired	Who is reminded, or null for the people on the event.
`reminders[].person.id`stringrequired	A person ID, such as per_01JC0000000000000000000000.
`reminders[].person.name`stringrequired	No description.
`attachments`array of objectsrequired
`attachments[].file_id`stringrequired	A file ID, such as fil_01JC0000000000000000000000.
`attachments[].name`stringrequired	No description.
`attachments[].position`integerrequired	No description.
`calendar`objectrequired
`calendar.id`stringrequired	A calendar ID, such as cal_01JC0000000000000000000000.
`calendar.name`stringrequired	No description.
`calendar.color`one of: calendar-1, calendar-2, calendar-3, calendar-4, calendar-5, calendar-6, calendar-7, calendar-8required	The calendar's color token.
`source`object or nullrequired	The app that owns the event, or null when it's the calendar's own.
`source.app`one of: meals, recipes, shopping, inventory, calendar, email, tasks, documents, chat, maintenancerequired	An app: meals (meal planning), recipes, shopping, inventory, calendar, email, tasks, documents, chat, or maintenance (home maintenance).
`source.record_id`stringrequired	The owning app's record.
`is_busy_only`booleanrequired	No description.

Errors#

Every error has the same envelope: error.code, error.message, error.details, error.recovery and error.request_id.

One event in full: errors
Status	Code	When
`400`	`validation_failed`	A field is missing, misspelled or out of range. details.fields lists each problem.
`401`	`unauthenticated`	The request has no valid session.
`404`	`event_not_found`	The event doesn't exist in this household.
`404`	`not_found`	The household doesn't exist, or you aren't a member of it.

Examples#

These are real. Each was recorded from a sample household, the Okafors, running through the whole API when this site was built.

Open an event

Request, curl

curl 'https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/calendar.event.get?event_id=evt_01M6V9CSHPG77MMGGKHAEJQ484' \
  -H "Cookie: rigel_session=$RIGEL_SESSION"

Request, TypeScript

const response = await fetch("https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/calendar.event.get?event_id=evt_01M6V9CSHPG77MMGGKHAEJQ484", {
  headers: {
    Cookie: `rigel_session=${process.env.RIGEL_SESSION}`,
  },
});
const data = await response.json();

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/calendar.event.get?event_id=evt_01M6V9CSHPG77MMGGKHAEJQ484 HTTP/1.1
Host: rigel.house
Cookie: rigel_session=<your session>

Response, 200

HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: req_01M6V9CSJPHN3RGJEYQ8AJFB9H

{
  "event_id": "evt_01M6V9CSHPG77MMGGKHAEJQ484",
  "title": "Soccer practice",
  "description": null,
  "location": "Riverside Park",
  "kind": "activity",
  "status": "confirmed",
  "is_all_day": false,
  "starts_at": "2026-11-10T17:00:00-06:00",
  "ends_at": "2026-11-10T18:00:00-06:00",
  "start_date": null,
  "end_date": null,
  "time_zone": "America/Chicago",
  "when": "Tue, Nov 10, 5–6pm",
  "recurrence": "FREQ=WEEKLY;BYDAY=TU",
  "repeats": "every Tuesday",
  "exceptions": [],
  "extra_dates": [],
  "people": [
    {
      "id": "per_01M6V9CS7CDAEP5VDA5T8R9TG6",
      "name": "Theo"
    }
  ],
  "reminders": [
    {
      "minutes_before": 60,
      "person": null
    }
  ],
  "attachments": [],
  "calendar": {
    "id": "cal_01M6V9CSHK7NNRTMZQSM1BFD1B",
    "name": "Nia and Theo",
    "color": "calendar-5"
  },
  "source": null,
  "is_busy_only": false
}

For Rigel#

Rigel's tool for this query is calendar_event_get. Rigel runs this on its own, then says what it did. The agent guide has the rest.