TripCreate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/goyondo-run/json-schema/goyondo-run-trip-create-schema.json",
  "title": "TripCreate",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/goyondo-run-api-openapi.json#/components/schemas/TripCreate",
  "type": "object",
  "required": [
    "destination",
    "start_date",
    "end_date"
  ],
  "properties": {
    "destination": {
      "type": "string"
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "end_date": {
      "type": "string",
      "format": "date"
    },
    "timezone": {
      "type": "string",
      "description": "Traveler IANA time zone (e.g. America/Los_Angeles). Used to decide whether start_date is in the past. Not stored."
    },
    "travelers": {
      "type": "integer",
      "default": 1
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dietary_restrictions": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "maxLength": 100
      }
    },
    "children": {
      "type": "object",
      "description": "Optional family composition. The total must leave at least one adult in travelers.",
      "properties": {
        "infants": {
          "type": "integer",
          "minimum": 0
        },
        "children": {
          "type": "integer",
          "minimum": 0
        },
        "teens": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "travel_style": {
      "type": "string",
      "enum": [
        "budget",
        "comfort",
        "luxury"
      ],
      "description": "Spending level. Older values adventure, cultural and relaxation are still accepted and become comfort plus a matching interest."
    },
    "accommodation_type": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "hotel",
        "hostel",
        "rental",
        "guesthouse",
        "resort",
        "camping",
        null
      ],
      "description": "Kind of place to stay, used for suggestions; null for no preference. Older values airbnb and apartment become rental, bb becomes guesthouse."
    },
    "skip_ai_generation": {
      "type": "boolean",
      "default": false
    },
    "origin": {
      "allOf": [
        {
          "$ref": "#/$defs/Location"
        }
      ],
      "nullable": true,
      "description": "Where the trip starts. Omitted: copied from the user's home base. null: no origin. Never changes the home base. Used to plan Day 1 and the last day around the flight."
    },
    "arrival_time": {
      "type": "string",
      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
      "description": "Local arrival time on Day 1 (HH:MM). Overrides the estimate from the origin."
    },
    "fixed_plans": {
      "type": "array",
      "maxItems": 15,
      "items": {
        "type": "object"
      },
      "description": "Tickets, reservations and must-sees the itinerary is built around. Each: title, timing (exact, day or flexible), category, place_id or city, sessions (one per day attended)."
    },
    "departure_time": {
      "type": "string",
      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
      "description": "Local departure time on the last day (HH:MM)."
    },
    "groupTripCode": {
      "type": "string",
      "description": "Collaborative group trip code. When present, the server loads board consensus and readiness context for itinerary generation."
    },
    "regeneration_mode": {
      "type": "string",
      "enum": [
        "replace",
        "new_version"
      ],
      "description": "Required when groupTripCode already has a linked itinerary. replace updates that itinerary; new_version creates and links a fresh trip."
    }
  },
  "$defs": {
    "Location": {
      "type": "object",
      "description": "City-level location (home base or trip origin). Give city or airport_iata; the server resolves coordinates, timezone and, when omitted, the nearest airport.",
      "properties": {
        "city": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "airport_iata": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$"
        }
      }
    }
  }
}