Create trip

post/api/trips

Request

  • Base URL: https://goyondo.run
  • URL: https://goyondo.run/api/trips
  • Auth: HTTP bearer

Request body

destinationstring required
start_datestring date required
end_datestring date required
timezonestring

Traveler IANA time zone (e.g. America/Los_Angeles). Used to decide whether start_date is in the past. Not stored.

travelersinteger
interestsstring[]
travel_style'budget' | 'comfort' | 'luxury' | 'adventure'
accommodation_type'hotel' | 'hostel' | 'airbnb' | 'resort' | 'camping' | 'bb'
skip_ai_generationboolean
arrival_timestring

Local arrival time on Day 1 (HH:MM). Overrides the estimate from the origin.

departure_timestring

Local departure time on the last day (HH:MM).

groupTripCodestring

Collaborative group trip code. When present, the server loads board consensus and readiness context for itinerary generation.

regeneration_mode'replace' | 'new_version'

Required when groupTripCode already has a linked itinerary. replace updates that itinerary; new_version creates and links a fresh trip.

Example request

{
  "origin": {
    "city": "Singapore",
    "airport_iata": "SIN"
  }
}

Response

Trip created (with itinerary if not skip_ai_generation)

Changes

No recorded changes to this operation across all 1 revision of this API.