Write the planning layer above an itinerary's day-by-day. Every block is optional — send only the ones you mean to write. Each block you DO send REPLACES that block entirely, so restate it in full: a partial legs list silently deletes the rest of the legs. Requires a bearer token.
View input schema
{
"type": "object",
"properties": {
"itinerary_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"countries": {
"description": "How many countries the route crosses",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"legs": {
"description": "The route's chapters. Every day must belong to exactly one leg, and legs must not overlap.",
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Where this stretch is, in a word or two"
},
"summary": {
"description": "A sentence or two on what these nights are for",
"type": "string"
},
"start_day": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"end_day": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"title",
"start_day",
"end_day"
]
}
},
"seasonality": {
"description": "One row per thing the trip is timed around, scored 0-3 across all twelve months, plus a verdict per month worth arguing about",
"type": "object",
"properties": {
"rows": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"description": "What is being scored — a wildlife event, a trail condition, a sea state"
},
"scores": {
"minItems": 12,
"maxItems": 12,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 3
},
"description": "January first. 0 = avoid, 1 = poor, 2 = workable, 3 = peak"
}
},
"required": [
"label",
"scores"
]
}
},
"months": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"rank": {
"type": "string",
"enum": [
"primary",
"alternative",
"workable",
"avoid"
]
},
"verdict": {
"type": "string",
"minLength": 1,
"description": "Why this month is or isn't the one, in two or three sentences"
},
"tags": {
"maxItems": 4,
"type": "array",
"items": {
"type": "string"
},
"description": "Short labels: 'Peak crossings', 'Books out first', 'Avoid'"
}
},
"required": [
"month",
"rank",
"verdict",
"tags"
]
}
},
"recommended_month": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"description": "The month this plan is actually built around"
}
},
"required": [
"rows",
"months",
"recommended_month"
]
},
"cost_model": {
"description": "Per-person breakdown lines, amounts per comfort tier, and any per-line choices",
"type": "object",
"properties": {
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3,
"description": "ISO 4217, lowercase — 'usd'"
},
"reference_nights": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "The trip length the amounts are quoted at"
},
"length_options": {
"description": "Shorter or longer variants offered to the reader, in nights",
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"lines": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"description": "Short stable key used by tiers and option groups — 'land', 'permits', 'park_fees', 'flights'"
},
"label": {
"type": "string",
"minLength": 1
},
"scales_with_length": {
"type": "boolean",
"description": "True for nightly costs (camps, park fees), false for per-trip costs (permits, internal flights)"
}
},
"required": [
"key",
"label",
"scales_with_length"
]
}
},
"tiers": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"description": "'Lean', 'Mid-range', 'Luxury'"
},
"amounts": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"line_key": {
"type": "string"
},
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Per person, in minor units — 620000 for $6,200"
}
},
"required": [
"line_key",
"amount"
]
},
"description": "One entry per cost line"
}
},
"required": [
"label",
"amounts"
]
}
},
"option_groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"line_key": {
"type": "string",
"minLength": 1,
"description": "Which cost line this choice overrides"
},
"options": {
"minItems": 2,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"amount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Per person, in minor units — 620000 for $6,200"
},
"is_default": {
"type": "boolean"
}
},
"required": [
"label",
"amount"
]
}
}
},
"required": [
"label",
"line_key",
"options"
]
}
},
"notes": {
"description": "What the figures exclude and how firm they are",
"type": "string"
}
},
"required": [
"currency",
"reference_nights",
"lines",
"tiers"
]
},
"booking_order": {
"description": "What to book, in the order it has to happen",
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"detail": {
"type": "string",
"minLength": 1,
"description": "Why it sits at this point in the order"
}
},
"required": [
"title",
"detail"
]
}
},
"field_notes": {
"description": "Visas, certificates, luggage limits, kit",
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"heading": {
"type": "string",
"minLength": 1,
"description": "'Visas', 'Yellow fever', 'Luggage'"
},
"body": {
"type": "string",
"minLength": 1
}
},
"required": [
"heading",
"body"
]
}
},
"choices": {
"description": "Either/ors deliberately left open for the traveller",
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "'Pick your coast'"
},
"options": {
"minItems": 2,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"subtitle": {
"type": "string"
},
"body": {
"type": "string",
"minLength": 1,
"description": "What this option is actually like, and who should choose it"
}
},
"required": [
"label",
"body"
]
}
}
},
"required": [
"title",
"options"
]
}
}
},
"required": [
"itinerary_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}