heart-routes

{'type': 'object', 'required': ['fundraising_url'], 'properties': {'city': {'type': 'string', 'description': 'Optional city to also pre-fill.'}, 'fundraising_url': {'type': 'string', 'description': 'Fully-qualified donation URL (https://www.justgiving.com/... / https://gofundme.com/... / https://leetchi.com/... / https://www.helloasso.com/...).'}}}

{'type': 'object', 'required': ['name'], 'properties': {'city': {'type': 'string', 'description': 'Optional city to also pre-fill in the builder (skips the "pick a city" step in the chat-to-product handoff).'}, 'name': {'type': 'string', 'description': 'Dedication name (e.g. "Marie", "Dad", "Cancer Research UK").'}, 'in_memory': {'type': 'boolean', 'description': 'If true, framed as "In memory of [name]". Default false.'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Route slug, e.g. "paris-7-2-km-heart-for-marie".'}}}

{'type': 'object', 'required': ['city'], 'properties': {'city': {'type': 'string', 'description': 'City name, e.g. "Paris", "Tokyo", "New York". Case-insensitive.'}, 'prefer_gold': {'type': 'boolean', 'default': True, 'description': 'If true, return only the highest AI-quality "gold" tier routes (ai_score >= 80). Default true.'}, 'max_distance_km': {'type': 'number', 'description': 'Optional max route length in kilometres. Filter to routes ≤ this distance. Common: 5, 10, 15, 21 (half-marathon).'}}}

{'type': 'object', 'required': ['city'], 'properties': {'city': {'type': 'string', 'description': 'City name, e.g. "Paris", "Tokyo".'}, 'cause_url': {'type': 'string', 'description': "Optional JustGiving / GoFundMe / Leetchi URL to embed in the GPX metadata. CityHeart never touches the money — the link is for the runner's Strava description to surface to donors."}, 'in_memory': {'type': 'boolean', 'description': 'If true, the dedication is framed as a memorial ("In memory of [name]"). Default false.'}, 'dedication': {'type': 'string', 'description': 'Optional person/cause name to bake into the heart (appears in the GPX, on Garmin Connect, and as the Strava activity title prefix).'}, 'distance_km': {'type': 'number', 'default': 7, 'description': 'Target route length in km (3–25). Default 7.'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Route slug, e.g. "paris-7-2-km-heart-for-marie".'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'default': 25, 'description': 'Max number of cities to return. Default 25, max 100.'}}}