v1

latestOpenAPI 3.0.02026-07-22469.0 KB
Events

Update an event's details

patch/v1/events/{id}

Path parameters

idstring required

The event's public id (UUID).

Request body

namestring

Event title.

formattedLocationsobject

Candidate locations. Each entry needs a city.

numPeoplenumber

Total attendees.

budgetBreakdownobject

Budget totals keyed by category: venue, fb, av, transport, flight, activities, merch, other.

flexibilitystring

Date flexibility. Send the exact string 'Dates not flexible' for no, free text for yes, or null if unanswered.

decisionDeadlinestring

ISO 8601 timestamp for the venue decision deadline.

accommodationsobject

Guestroom counts per night, keyed YYYY-MM-DD. Room types: Single, Double, Twin, ROH, Suite, Staff, VIP.

meetingRoomDatesobject

Agenda date ranges, both ends inclusive.

numMeetingRoomsNeedednumber

Separate meeting rooms needed.

foodBeverageRequirementsstring

Food and beverage notes.

meetingRoomsstring

Meeting room notes.

otherNotesstring

Additional notes.

notesForVenuestring

Notes shown to the venue.

decisionFactorsstring[]

What drives the venue decision.

decisionFactorOtherTextstring

Free text, used when 'Other' is among the decision factors.

additionalServicesstring[]

Extra services requested.

agendaOperationsobject

Agenda session changes, addressed by session id so a single edit need not restate the whole agenda.

Example request

{
  "name": "Annual Summit",
  "numPeople": 300,
  "budgetBreakdown": {
    "venue": 120000,
    "fb": 40000
  },
  "decisionDeadline": "2026-09-01T00:00:00.000Z",
  "accommodations": {
    "2026-09-14": {
      "Single": 200,
      "Double": 50
    }
  },
  "decisionFactors": [
    "Price and Budget",
    "Location and Accessibility"
  ],
  "additionalServices": [
    "Onsite Support"
  ]
}

Response

The updated event details