Event
An event post with scheduling, location, and RSVP data. id and resourceId
name the event record — one record however many times the event repeats. A
single occurrence of a repeating event is an EventInstance, reached through
eventInstance or upcomingEventInstances.
Required scopes: read:network, write:posts, write:comments,
write:rsvps, host:read:network, host:read:network_posts,
host:write:network_posts, host:read:network_events,
host:write:network_events (any one)
EventImplements
Fields
Attached media assets (images, files, videos)
Deprecated alias for bodyHtml — the post's textual content as HTML.
HTML content with formatted mentions, hashtags, and links
Plain text content (raw, no formatting). Content hidden with the hidden
attribute, an inline display: none, or an inline visibility: hidden is excluded.
Comments on this post
Returns the elements in the list that come after the specified cursor.
Returns the elements in the list that come before the specified cursor.
Returns the first n elements from the list.
Returns the last n elements from the list.
When true, return only root comments (exclude replies). Use this for feed
views where replies are fetched via each comment's replies connection.
Content kind from the underlying NewContent model (e.g. text, link, article, file)
Link-preview metadata — populated for link-type posts only
The record's own scheduled end, in UTC. When the event repeats this is the end
of the series anchor rather than of the next occurrence, and it stays put as
occurrences pass. A single occurrence carries its own times on
EventInstance.endsAt. Null when no end time is set.
The current/upcoming event instance, or a specific occurrence when instanceIndex is given.
ICS UTC-format occurrence key selecting a specific occurrence (e.g. "20240115T160000Z"). Omit for the current/upcoming instance.
Event category (e.g. conference, workshop)
URL members join the event through (e.g. the Zoom or Google Meet link). Null for a viewer who may not have it: a restricted event hands it out only to members attending it — going or maybe, on any occurrence — and to anyone who can edit the event.
External provider type for the event link (e.g. zoom, google_meet, youtube)
Position in the owning space's featured pin list; null when not pinned.
Whether the event has an external provider link (e.g. external livestream URL)
Header/banner image for the post (drives the event card banner). Returns the default-placeholder header when no header asset is set.
Header/banner image URL for the event card (cinema header, or the header video's preview image).
ID of the object.
Primary image URL
True when the post leads with audio, either as the header media or in the body. Never true at the same time as isVideo. A cheap scalar for list views; use primaryMedia to actually render a player.
True when the post's weekly activity score meets the owning space's trending threshold
True when the post leads with a video — a video in the header media slot, a header video embed, a video the post carries as its own medium (a coursework lesson's or landing page's video, even when a Host gives it a still thumbnail), a video whose own still frame is the post's image, or a video-image override. False when the post carries a video only in its body while a separate image leads it. Never true at the same time as isAudio: audio header media wins, then video, then body audio. False on a native mobile client that has not declared it can render a native video in the primary media slot, which is served no primaryMedia node either.
When the post last saw activity — its own last save, or a new comment landing on it. Use it to sort by recency or to poll for changes.
Latitude derived by geocoding the event’s street and city; null when the address has not been geocoded.
Deprecated alias for venue.
Longitude derived by geocoding the event’s street and city; null when the address has not been geocoded.
Aspect ratio of the primary image
Position in the network-level featured pin list; null when not pinned.
Position in the network-level welcome-checklist pin list; null when not pinned.
Whether the event appears in the activity feed
Post type enum (post, article, event, poll, introduction, etc.)
The post's hero media upload — native audio or native video attached as the header. Null when the post has no header media; clients branch on the node's presence and type rather than on a boolean. Also null for a native video on a native mobile client that has not declared it can render one in this slot.
External meeting ID members use to join the event. For Zoom events using a personal meeting ID, this is the ID parsed from the meeting link; otherwise the provider's external ID.
Emoji reaction counts grouped by base emoji (skin-tone modifiers are stripped server-side).
Per-occurrence exceptions on this recurring event (deletions and time/RSVP overrides), ordered by occurrence.
Returns the elements in the list that come after the specified cursor.
Returns the elements in the list that come before the specified cursor.
Returns the first n elements from the list.
Returns the last n elements from the list.
How often the series repeats: DAILY, WEEKLY, MONTHLY or YEARLY. Null for a one-off event.
How many frequency periods apart the occurrences are — 2 with a WEEKLY frequency means every other week. Null for a one-off event.
iCalendar RRULE string driving the series (e.g. "FREQ=WEEKLY;INTERVAL=2;BYDAY=MO"). Null for a one-off event.
Human-readable recurrence rules, one per UTC-offset range; null for single events.
Resource ID for this object, for interop with the Admin API.
Whether the event link is restricted to members attending the event. When false, every member who can read the event can see the link.
RSVPs for this event. Omit instanceAt for the roster across the whole
series; pass it to scope to one occurrence of a repeating event.
Required scopes: read:network, write:posts, write:comments,
host:read:network, host:read:network_posts, host:write:network_posts,
host:read:network_events, host:write:network_events (any one)
Returns the elements in the list that come after the specified cursor.
Returns the elements in the list that come before the specified cursor.
Returns the first n elements from the list.
The occurrence to scope to, given as its scheduled time — the unoverridden
time the recurrence rule produces, which EventInstance.instanceIndex
encodes. Equal to EventInstance.startsAt only when the occurrence carries
no time override. Series-level RSVPs are returned merged with instance-level
overrides, so the roster is wider than the RSVPs recorded against this
occurrence alone.
Returns the last n elements from the list.
Whether the current viewer has saved (bookmarked) this post
The record's own scheduled start, in UTC. When the event repeats this is the
series anchor the recurrence rule is calculated from, which stays put as
occurrences pass. A single occurrence carries its own times on
EventInstance.startsAt. Null when no start time is set.
Space tags associated with this post (used for feed card context)
Up to 3 upcoming occurrences for a recurring event; empty for single events.
Canonical URL of the post.
Free-text venue or place name, distinct from the street and city address. It does not contribute to the event’s coordinates — those come from street and city.
The current member's own mute/hide/report flag on this post, or null if they have none.
Position in the owning space's welcome pin list; null when not pinned.