Bucket lists

Bucket-list items are categorized places or experiences on a trip. Each item is either unscheduled (brainstorm-only) or scheduled (linked to an itinerary event via scheduledEventId).

list_bucket_list_items

Returns every item on a trip with id, title, category, notes, city, address, country, lat, lng, scheduledEventId, and orderIndex. A non-null scheduledEventId means the item has been promoted to the itinerary.

{ "tripId": "trp_..." }

add_bucket_list_item

category is one of: attraction, food_drink, event, shopping, entertainment, nature, culture, nightlife, wellness, other (defaults to attraction). If you provide a city without lat / lng, coordinates are geocoded automatically.

{
  "tripId": "trp_...",
  "title": "Cherry blossoms at Ueno Park",
  "category": "nature",
  "city": "Tokyo",
  "country": "Japan",
  "notes": "Best mid-April"
}

update_bucket_list_item

Only provided fields are updated. Nullable fields accept null to clear. Changing city without lat/lng re-geocodes.

{ "itemId": "bkt_...", "notes": "Skip on weekends" }

add_bucket_list_item_to_itinerary

Promotes an item to a scheduled itinerary event on a specific day. By default the bucket-list item is kept with scheduledEventId set so you can see what's been scheduled; pass "removeFromBucketList": true to delete it after.

{
  "itemId": "bkt_...",
  "tripId": "trp_...",
  "dayNumber": 3,
  "time": "10:00"
}

dayNumber is 1-indexed within the trip.

unmark_bucket_list_item

Clears the scheduledEventId on a bucket-list item, reverting it to unscheduled. Use when the linked itinerary event was deleted or you want to re-schedule.

{ "itemId": "bkt_..." }

delete_bucket_list_item

{ "itemId": "bkt_..." }