---
title: "Update fields on an event."
method: PATCH
path: "/v1/trips/{id}/variants/{variantId}/events/{eventKey}"
tags: ["Public API v1"]
---

# Update fields on an event.

`PATCH /v1/trips/{id}/variants/{variantId}/events/{eventKey}`

## Request

- Base URL: `https://api.mynextadventure.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mynextadventure.cloud/v1/trips/{id}/variants/{variantId}/events/{eventKey}`
- Auth: API key in header `X-API-Key`

## Path parameters

- `id` string, required
- `variantId` string, required
- `eventKey` string, required

## Request body

- UpdateEventV1Dto
  - `name` string: Display name of the event exactly as a human would call it (e.g. "Louvre Museum"). Never embed price, dates, status or commentary here — those belong in totalCost, start/end and notes.
  - `start` string, date-time
  - `end` string, date-time
  - `location` CreateEventLocationV1Dto
    - `googlePlaceId` string
    - `locationiqPlaceId` string
    - `name` string
    - `formattedAddress` string: Full postal address. Takes precedence over `address` when both are sent.
    - `address` string: Alias of `formattedAddress`, matching the option endpoints.
    - `coordinates` CreateEventLocationCoordinatesV1Dto
      - `lat` number, required: Latitude.
      - `lng` number, required: Longitude.
    - `latitude` number: Alias of `coordinates.lat`, matching the option endpoints. Must be sent with `longitude`.
    - `longitude` number: Alias of `coordinates.lng`, matching the option endpoints. Must be sent with `latitude`.
  - `eventType` 'concert' | 'course' | 'sport' | 'entertainment' | 'museum' | 'trip' | 'restaurant' | 'shopping' | 'other'
  - `maxTravelTimeToEventInMinutes` number
  - `totalCost` number
  - `currency` string
  - `link` string
  - `userUploadedImageUrl` string
  - `notes` string: Free-form commentary: provenance, caveats, trade-offs. Anything without a dedicated field goes here, not in name.

## Response `200`

- EventToAttendV1Dto
  - `key` string, required
  - `name` string, required
  - `start` string, date-time
  - `end` string, date-time
  - `location` EventLocationV1Dto
    - `googlePlaceId` string
    - `name` string
    - `formattedAddress` string
    - `coordinates` EventLocationCoordinatesV1Dto
      - `lat` number, required
      - `lng` number, required
  - `eventType` string
  - `totalCost` number
  - `currency` string
  - `link` string
  - `notes` string
  - `userUploadedImageUrl` string: Photo of the place, shown on the map popup.
  - `selected` boolean, required
  - `createdBy` string

## Other responses

- `404`: Trip, variant, or event not found, or no edit access.

---

[API](https://skmtc.dev/mynextadventure/apis/mynextadventure-public-api.md) · [All operations](https://skmtc.dev/mynextadventure/apis/mynextadventure-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mynextadventure/apis/mynextadventure-public-api/revisions/a246114e73a0?raw)