> ## Documentation Index > Fetch the complete documentation index at: https://docs.nowadays.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update event > Change an event's planning details. Omitted fields are left alone and an explicit null clears a field. If any field is rejected, nothing is written. ## OpenAPI ````yaml /openapi.json patch /v1/events/{id} openapi: 3.0.0 info: title: Nowadays Public API description: Public developer API for reading Nowadays data. version: '1.0' contact: {} servers: - url: https://api.nowadays.ai security: [] tags: [] paths: /v1/events/{id}: patch: tags: - Events summary: Update event description: >- Change an event's planning details. Omitted fields are left alone and an explicit null clears a field. If any field is rejected, nothing is written. operationId: PublicEventsController_update parameters: - name: id required: true in: path description: The event's public id (UUID). schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateEventDetailsDto' responses: '200': description: The event's refreshed details, ready to read back and re-send content: application/json: schema: $ref: '#/components/schemas/PublicEventDetailsViewDto' '400': description: Malformed event id or field '401': description: Missing or invalid API key '404': description: Event not found '409': description: Event is cancelled, or the change would drop agenda sessions '429': description: Rate limit exceeded security: - x-api-key: [] components: schemas: UpdateEventDetailsDto: type: object properties: name: type: string description: Event title. example: Annual Summit formattedLocations: type: object description: Candidate locations. Each entry needs a `city`. example: - city: Austin state: TX country: USA numPeople: type: number description: Total attendees. example: 300 budgetBreakdown: type: object description: >- Budget totals keyed by category: venue, fb, av, transport, flight, activities, merch, other. example: venue: 120000 fb: 40000 flexibility: type: string description: >- Date flexibility. Send the exact string 'Dates not flexible' for no, free text for yes, or null if unanswered. decisionDeadline: type: string description: ISO 8601 timestamp for the venue decision deadline. example: '2026-09-01T00:00:00.000Z' accommodations: type: object description: >- Guestroom counts per night, keyed YYYY-MM-DD. Room types: Single, Double, Twin, ROH, Suite, Staff, VIP. example: '2026-09-14': Single: 200 Double: 50 meetingRoomDates: type: object description: Agenda date ranges, both ends inclusive. example: - startDate: '2026-09-15' endDate: '2026-09-17' numMeetingRoomsNeeded: type: number description: Separate meeting rooms needed. foodBeverageRequirements: type: string description: Food and beverage notes. meetingRooms: type: string description: Meeting room notes. otherNotes: type: string description: Additional notes. notesForVenue: type: string description: Notes shown to the venue. decisionFactors: description: What drives the venue decision. example: - Price and Budget - Location and Accessibility type: array items: type: string decisionFactorOtherText: type: string description: Free text, used when 'Other' is among the decision factors. additionalServices: description: Extra services requested. example: - Onsite Support type: array items: type: string agendaOperations: type: object description: >- Agenda session changes, addressed by session id so a single edit need not restate the whole agenda. example: - op: update sessionId: abc session: title: Keynote PublicEventDetailsViewDto: type: object properties: id: type: string description: Stable public identifier (UUID). example: 3f1a2b4c-5d6e-7f80-9a1b-2c3d4e5f6071 name: type: string example: Annual Summit status: type: string description: Planning status. example: wait_for_proposals currency: type: string description: ISO 4217 currency code. example: USD location: type: string description: Derived from `formattedLocations`. Read-only. example: Austin, TX, USA eventDates: description: >- Derived from the union of guestroom nights and agenda ranges. Read-only. type: array items: $ref: '#/components/schemas/PublicDateRangeDto' formattedLocations: type: array items: $ref: '#/components/schemas/PublicFormattedLocationDto' numPeople: type: number description: Total attendees. example: 300 budgetBreakdown: type: object description: Budget line item → amount, in `currency`. additionalProperties: type: number example: venue: 50000 catering: 20000 flexibility: type: string description: How firm the dates are, in the requester's own words. nullable: true example: Can shift a week either way decisionDeadline: type: string nullable: true example: '2026-12-01' accommodations: type: object description: >- Room block: night (`YYYY-MM-DD`) → counts per room type (Single, Double, Twin, ROH, Suite, Staff, VIP). additionalProperties: type: object additionalProperties: type: number example: '2027-03-15': Single: 60 Double: 11 meetingRoomDates: type: array items: $ref: '#/components/schemas/PublicDateRangeDto' agenda: type: array items: $ref: '#/components/schemas/PublicAgendaItemDto' numMeetingRoomsNeeded: type: number nullable: true example: 3 foodBeverageRequirements: type: string nullable: true example: Buffet lunch both days meetingRooms: type: string nullable: true example: Two breakouts of 50 otherNotes: type: string nullable: true example: Bring badges notesForVenue: type: string nullable: true decisionFactors: example: - Price - Location type: array items: type: string decisionFactorOtherText: type: string nullable: true additionalServices: example: - AV support type: array items: type: string required: - id - name - status - currency - location - eventDates - formattedLocations - numPeople - budgetBreakdown - flexibility - decisionDeadline - accommodations - meetingRoomDates - agenda - numMeetingRoomsNeeded - foodBeverageRequirements - meetingRooms - otherNotes - notesForVenue - decisionFactors - decisionFactorOtherText - additionalServices PublicDateRangeDto: type: object properties: startDate: type: string description: First day, `YYYY-MM-DD`. example: '2027-03-15' endDate: type: string description: Last day, `YYYY-MM-DD`. example: '2027-03-17' required: - startDate - endDate PublicFormattedLocationDto: type: object properties: city: type: string example: Austin state: type: string example: TX country: type: string example: USA formatted_address: type: string example: Austin, TX, USA place_id: type: string example: ChIJLwPMoJm1RIYRetVp1EtGm10 PublicAgendaItemDto: type: object properties: id: type: string description: >- Stable session id. Use it to address this session in `agendaOperations`. example: a1b2c3d4-5e6f-7080-9a1b-2c3d4e5f6071 title: type: string example: Closing keynote dates: description: The days this session runs, each `YYYY-MM-DD`. example: - '2027-03-17' type: array items: type: string startTime: type: string description: 24-hour `HH:MM`. example: '16:00' endTime: type: string description: 24-hour `HH:MM`. example: '17:00' roomType: type: string example: Ballroom capacity: type: number description: Expected attendees. example: 300 avRequirements: example: - Projector type: array items: type: string fbRequirements: example: - Coffee type: array items: type: string avOtherText: type: string description: Free-text AV needs not covered above. fbOtherText: type: string description: Free-text F&B needs not covered above. notes: type: string description: Free-text session notes. useInternalSpace: type: boolean internalOfficeId: type: number internalOfficeName: type: string required: - id - title - dates - startTime - endTime - roomType - capacity - avRequirements - fbRequirements - avOtherText - fbOtherText - notes securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ````