event

Something that happens — at a time, optionally at a place, involving people.

The universal base for anything with a when: meetings, classes, parties, conferences, concerts, life events. Subtypes extend via also: [event].

Standard fields (inherited): id, name, url, image, published, content published is when the event was posted/announced — NOT when it happens. Use startDate / endDate for the actual event timing.

Metadata	Value
Plural	`events`
Subtitle field	`eventType`
Identity	`platform`, `id`

Fields

Field	Type
`eventType`	`string`
`startDate`	`datetime`
`endDate`	`datetime`
`timezone`	`string`
`allDay`	`boolean`
`recurrence`	`string[]`
`status`	`string`
`visibility`	`string`
`showAs`	`string`
`dateUpdated`	`datetime`
`sourceUrl`	`url`
`sourceTitle`	`string`
`icalUid`	`string`

Relations

Relation	Target
`platform`	`product`
`involves`	`person[]`
`location`	`place`
`organizer`	`person`
`creator`	`person`
`attachments`	`file[]`

Used as a base by

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

schema.org/Event — Core event type. Our startDate/endDate map 1:1; eventType is free-form vs. schema.org’s subtype hierarchy (Concert, Conference, BusinessEvent). organizer/location match directly.
RFC 5545 (iCalendar) VEVENT — Our icalUid is their UID; recurrence is their RRULE; status maps to STATUS (TENTATIVE/CONFIRMED/CANCELLED); showAs ≈ TRANSP; involves[] ≈ ATTENDEE.
ActivityStreams 2.0 Event — Fediverse inbox format. Thinner than iCal — no native recurrence or showAs; our involves[] ≈ attendees via as:Relationship.

Skills that produce this shape

google-calendar — list_events, search_events, get_event, create_event, update_event
spacex — list_upcoming, list_past, get_launch
posthog — list_events, get_event