Update a trip

PATCH/v1/trips/{tripId}

Changes any field an agent can edit in the app: title, startDate, endDate, travelers (1–40; refused while a quote is accepted), ownerId (an active staff member), design, presentation, profile, and metadata. An absent field is unchanged and null clears it. presentation and profile are replaced as a whole. metadata merges key by key, and "key": null deletes that key. Changing the dates re-dates the itinerary, as the app does. Changing design does not rebuild the itinerary's days: call POST /trips/{tripId}/itinerary/sync. With ?dryRun=true, returns a trip_change_preview listing each field's from/to.

Permissions: trips:write · Kind: write · Cost: 1 unit · Dry run: ?dryRun=true · MCP tool update_trip

Undoable: the response carries Bymundi-Change-Id; revert it with POST /v1/changes/{changeId}/revert.

Path parameters

Field	Type	Required	Description
`tripId`	uuid	yes

Body

Field	Type	Required	Description
`title`	string
`startDate`	string \| null
`endDate`	string \| null
`travelers`	integer		1–40
`ownerId`	uuid \| null
`design`	object \| null
`design.version`	1	yes
`design.originCity`	string	yes
`design.stops`	object[]	yes	max 60 items
`design.stops[].id`	string	yes
`design.stops[].city`	string	yes
`design.stops[].nights`	integer	yes	0–365
`design.stops[].transferBefore`	object \| null	yes
`design.stops[].escala`	boolean		default false
`design.stops[].place`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.returnCity`	string \| null	yes
`design.returnTransfer`	object \| null	yes
`design.returnTransfer.id`	string	yes
`design.returnTransfer.departDate`	string \| null	yes
`design.returnTransfer.arriveDate`	string \| null	yes
`design.returnTransfer.days`	integer		0–30, default 0
`design.returnTransfer.departTime`	string		default ""
`design.returnTransfer.arriveTime`	string		default ""
`design.returnTransfer.flight`	object		default {"flightNo":"","airline":"","fromAirport":"","toAirport":"","source":"","fetchedAt":"","scheduleValidFor":""}
`design.originPlace`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.originPlace.placeId`	string		default ""
`design.originPlace.lat`	number \| null		default null
`design.originPlace.lng`	number \| null		default null
`design.originPlace.formattedAddress`	string		default ""
`design.returnPlace`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.returnPlace.placeId`	string		default ""
`design.returnPlace.lat`	number \| null		default null
`design.returnPlace.lng`	number \| null		default null
`design.returnPlace.formattedAddress`	string		default ""
`presentation`	object \| null
`presentation.logoUrl`	uri \| null
`presentation.brandColor`	string \| null
`presentation.fontFamily`	"inter" \| "montserrat" \| "poppins" \| "lora" \| "playfair" \| "source-sans" \| null
`presentation.headerMedia`	object \| null
`presentation.headerMedia.type`	"image" \| "video"	yes
`presentation.headerMedia.url`	uri	yes
`profile`	object \| null
`profile.pace`	"relajado" \| "equilibrado" \| "intenso" \| null
`profile.profiles`	"primera_vez" \| "repetidor" \| "familia_ninos" \| "pareja" \| "grupo" \| "senior" \| "movilidad_reducida" \| "cultural" \| "gastronomico" \| "naturaleza" \| "fotografia" \| "otaku" \| "compras" \| "presupuesto_ajustado" \| "premium"[]
`profile.mobility`	"normal" \| "reducida"
`profile.avoid`	string[]
`profile.notes`	string
`metadata`	object

Response `200`

One of:

`trip`

Field	Type	Required	Description
`object`	"trip"	yes
`id`	uuid	yes
`code`	string	yes
`title`	string	yes
`startDate`	string \| null	yes
`endDate`	string \| null	yes
`publication`	"draft" \| "published"	yes
`commercialState`	"nueva" \| "propuesta_enviada" \| "aceptada" \| "reserva_provisional" \| "reservada" \| "rechazada" \| "cancelada"	yes
`travelers`	integer	yes
`ownerId`	uuid \| null	yes
`design`	object \| null	yes
`design.version`	1	yes
`design.originCity`	string	yes
`design.stops`	object[]	yes	max 60 items
`design.stops[].id`	string	yes
`design.stops[].city`	string	yes
`design.stops[].nights`	integer	yes	0–365
`design.stops[].transferBefore`	object \| null	yes
`design.stops[].escala`	boolean		default false
`design.stops[].place`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.returnCity`	string \| null	yes
`design.returnTransfer`	object \| null	yes
`design.returnTransfer.id`	string	yes
`design.returnTransfer.departDate`	string \| null	yes
`design.returnTransfer.arriveDate`	string \| null	yes
`design.returnTransfer.days`	integer		0–30, default 0
`design.returnTransfer.departTime`	string		default ""
`design.returnTransfer.arriveTime`	string		default ""
`design.returnTransfer.flight`	object		default {"flightNo":"","airline":"","fromAirport":"","toAirport":"","source":"","fetchedAt":"","scheduleValidFor":""}
`design.originPlace`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.originPlace.placeId`	string		default ""
`design.originPlace.lat`	number \| null		default null
`design.originPlace.lng`	number \| null		default null
`design.originPlace.formattedAddress`	string		default ""
`design.returnPlace`	object		default {"placeId":"","lat":null,"lng":null,"formattedAddress":""}
`design.returnPlace.placeId`	string		default ""
`design.returnPlace.lat`	number \| null		default null
`design.returnPlace.lng`	number \| null		default null
`design.returnPlace.formattedAddress`	string		default ""
`presentation`	object	yes
`presentation.logoUrl`	uri \| null
`presentation.brandColor`	string \| null
`presentation.fontFamily`	"inter" \| "montserrat" \| "poppins" \| "lora" \| "playfair" \| "source-sans" \| null
`presentation.headerMedia`	object \| null
`presentation.headerMedia.type`	"image" \| "video"	yes
`presentation.headerMedia.url`	uri	yes
`profile`	object	yes
`profile.pace`	"relajado" \| "equilibrado" \| "intenso" \| null		default null
`profile.profiles`	"primera_vez" \| "repetidor" \| "familia_ninos" \| "pareja" \| "grupo" \| "senior" \| "movilidad_reducida" \| "cultural" \| "gastronomico" \| "naturaleza" \| "fotografia" \| "otaku" \| "compras" \| "presupuesto_ajustado" \| "premium"[]		default []
`profile.mobility`	"normal" \| "reducida"		default "normal"
`profile.avoid`	string[]		default []
`profile.notes`	string		default ""
`coverImageUrl`	string \| null	yes
`coverage`	object \| null	yes
`coverage.state`	"sin_cobros" \| "pago_parcial" \| "pagado"	yes
`coverage.percent`	integer	yes
`coverage.overpaid`	boolean	yes
`metadata`	object	yes
`appUrl`	string \| null	yes
`publicUrl`	string \| null	yes
`createdAt`	string	yes
`updatedAt`	string	yes

`trip_change_preview`

Field	Type	Required
`object`	"trip_change_preview"	yes
`tripId`	uuid	yes
`changes`	object[]	yes
`changes[].field`	string	yes
`changes[].from`	any
`changes[].to`	any

Errors

Errors are problem details. Besides the refusals described above, any call like this one can return:

invalid_request — Invalid request
unauthorized — Missing or invalid API key
insufficient_scope — Missing permission
rate_limited — Rate limit reached
not_found — Not found
idempotency_key_reused — Idempotency-Key reused
request_in_progress — Request in progress

Update a trip

#Path parameters

#Body

#Response 200

#trip