Skip to main content

event.item.updated

An existing event's data changed (time, venue, status, images).

Delivery Metadata​

FieldValue
Scopefeed
Feed typeevents
Source/feeds/events/{feedId}
SubjectThe event feed item id.

Event Data Schema​

The data field in the event payload contains the following structure:

FieldTypeRequiredDescription
feedIdstring (uuid)YesID of the event feed that was updated
idstring (uuid)YesID of the event feed item that was updated. Use with [`GET /feeds/events/{feedId}/items/{id}`](/docs/event-feeds/api-reference#get-a-single-feed-item) to fetch the current item.
eventIdstring (uuid)YesID of the event that was updated
changedFieldsarrayYesWhich groups of the event changed in this update, compared with the previous update, at least one: `title`; `description` (description or short description); `when` (dates or times changed); `where` (the location changed); `links` (the URLs of the event or its sources, who published what, changed); `status` (cancelled or restored); `media` (the cover image or the gallery); `price` (reserved, never sent). A hint, not a complete record: debounce can collapse several updates into the newest one, so earlier changes may be missing. Re-fetch the item on every `event.item.updated`; a cancellation shows as the top-level `status: "cancelled"`.

Example Payload​

Complete example of a CloudEvents-formatted event payload for this event type. The id field is the envelope identifier — stable across retries; use it as your idempotency key.

{
"specversion": "1.0",
"type": "event.item.updated",
"source": "/feeds/events/{feedId}",
"subject": "123e4567-e89b-12d3-a456-426614174000",
"id": "456e7890-a12b-34c5-d678-901234567890",
"time": "2024-01-15T10:30:00.000Z",
"datacontenttype": "application/json",
"data": {
"feedId": "123e4567-e89b-12d3-a456-426614174000",
"id": "123e4567-e89b-12d3-a456-426614174000",
"eventId": "123e4567-e89b-12d3-a456-426614174000",
"changedFields": [
"title"
]
}
}