← Docs/Recipes
Recipe

Trip itinerary builder

Generate a day-by-day travel plan from a destination and date range.

Overview

This recipe accepts a city, arrival date, departure date, and optional interests. It returns a structured itinerary with morning, afternoon, and evening blocks per day, including venue names, estimated durations, and transit notes.

Input schema

{
  "destination": "string",
  "arrival": "YYYY-MM-DD",
  "departure": "YYYY-MM-DD",
  "interests": ["string"],
  "pace": "relaxed | balanced | packed"
}

Output shape

{
  "days": [
    {
      "date": "string",
      "morning": { "venue": "...", "duration": "..." },
      "afternoon": { "venue": "...", "duration": "..." },
      "evening": { "venue": "...", "duration": "..." },
      "transit_notes": "string"
    }
  ]
}

Example call

POST /v1/run/recipe-trip-itinerary
Content-Type: application/json

{
  "destination": "Kyoto",
  "arrival": "2026-04-10",
  "departure": "2026-04-13",
  "interests": ["temples", "street food"],
  "pace": "balanced"
}