add_program_info_card
ChatGPTAdd an info/rule card to a program. Params: id (program uuid) + body { kind (info|rule), title, body } -- at least one of title OR body must be filled (the inner 'body' here is the card text).
add_program_item
ChatGPTAdd a stop/leg to a program. Params: id (program uuid) + body { templateId OR label (at least one required), dayNumber, notes, kind (tour|activity|place|meal|transfer|free_time|accommodation|info), startTime (HH:MM, OPTIONAL -- do NOT pass it if the time is unknown; the order is already set by dayNumber + insertion order/reorder_program_items), locationText (stop name/address for the map route), locationLat, locationLng, durationMin, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules. Copied into trips created from this program.
add_template_info_card
ChatGPTAdd an info card to a template. Params: id (uuid) + body { title (required), description, triggerType, linkedScheduleStopId }.
add_template_schedule_stop
ChatGPTAdd a schedule stop to a template. Params: id (uuid) + body { title (required), description, estimatedTime (min), latitude, longitude, linkedInfoCardId, linkedSlideIndex, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
add_text_slide
ChatGPTAdd a TEXT slide to a template (at the end). Params: id (uuid) + body { caption }. IMAGE slides cannot be added through this channel -- upload them from the app/panel.
add_trip_item
ChatGPTAdd a stop to a trip. Params: id (trip uuid) + body { templateId OR label, dayNumber, notes, kind, startTime (HH:MM), locationText, locationLat, locationLng, durationMin, headsetPolicy }. headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules. NO notification is sent.
add_trip_participant
ChatGPTManually add a participant to a trip. Params: id (trip uuid) + body { displayName (required), email, phone }. Does NOT SEND an EMAIL (for an invite link use invite_trip_participant). Safe to retry: if the same person (same email or phone, or same name without conflicting contact details) is already on the trip, the existing participant is returned and no duplicate is created.
create_program
ChatGPTCreate a new travel program (multi-day trip draft). Fields: name (required), description, language, estimatedDays, category, country, city, region, tags (max 20), visibility (personal|org).
create_template
ChatGPTCreate a new tour template. Fields: name (required), description, language, estimatedDuration (min), tourType, tourFormat (single|multi_stop), category, country, city, region, visibility (personal|org -- org only for a company owner/manager), broadcastMode (offline|online|both), routerProfileId. The plan quota applies.
create_trip
ChatGPTCreate a new TRIP from a program (the program's current state is snapshotted). Fields: programId (uuid, REQUIRED -- a trip is always a live instance of a program), name, startDate, endDate (YYYY-MM-DD), maxParticipants (null = unlimited), timezone (IANA name, e.g. 'Europe/Istanbul'). A new trip starts as a DRAFT and is NOT LISTED on the company website; to open it for sale/on the site, use publish_trip.
delete_program
ChatGPTDelete a travel program. Params: id (uuid). The program's non-completed trips without participants are deleted too (returned as deletedTrips { count, names }) and its listing is removed from the company website draft (publishing is a separate step); if an open trip with participants exists, deletion stops with itinerary.delete_blocked_by_trips (details.trips lists the blocking trips with id, name, status, participants; cancel or complete them first). Completed trips remain as history records (keptCompletedTrips).
delete_program_info_card
ChatGPTDelete a program info card. Params: id (program uuid), cardId (uuid).
delete_program_item
ChatGPTDelete a program stop. Params: id (program uuid), itemId (uuid).
delete_slide
ChatGPTDelete a slide. Params: id (template uuid), slideId (uuid).
delete_template
ChatGPTDelete your own template (together with its sub-resources). Params: id (uuid).
delete_template_info_card
ChatGPTDelete an info card. Params: id (template uuid), cardId (uuid).
delete_template_schedule_stop
ChatGPTDelete a schedule stop. Params: id (template uuid), stopId (uuid).
delete_trip
ChatGPTPermanently DELETE a trip (a wrong or duplicate departure, or one whose program was deleted). Works only on a trip that has no (joined) participants and is not completed; for a trip with participants use announce_trip_cancellation. NO notification is sent. Params: id (trip uuid).
delete_trip_item
ChatGPTDelete a trip stop. Params: id (trip uuid), itemId (uuid). NO notification is sent.
draft_legal_document
ChatGPTDraft a legal document with AI, or rewrite the existing custom text following instructions (markdown). Params: key (terms|privacy|cookies|kvkk|refund|distanceSales|preInfo|accessibility), lang (default: the site's language), instructions (optional), apply (default true: written to the DRAFT as legal.docs[key] with source='custom', customBody=draft, enabled=true; false: only returns the text). Company details are taken from the site document (imprint/contact); if they are missing, fill content.imprint first. NOT LEGAL ADVICE: human review is required before publishing; site terms acceptance (legal.siteTermsAcceptedAt) is given in the panel. Deducted from translation credit.
duplicate_program
ChatGPTDeep-copy a program (create a variant). Params: id (uuid) + body { name?, visibility? }.
duplicate_template
ChatGPTCopy your own template (or a company template open to you) into a NEW template; sub-resources are deep-copied. Params: id (uuid) + body { visibility? }. The copy gets an AUTOMATIC name -- to rename it, call update_template afterwards. The plan quota applies.
get_my_audience
ChatGPTYour audience: country/language/device BREAKDOWN of participants (aggregate counts, not personal identities).
get_my_program
ChatGPTDetails of one travel program: stops/items + info cards. Params: id (uuid).
get_my_ratings_summary
ChatGPTYour ratings summary: total count, average score and 1-5 star distribution.
get_my_ratings_trend
ChatGPTYour rating trend: average stars + rating count as a time series. Params: days, granularity (day|week).
get_my_session
ChatGPTDetails of one of your tours: session facts, participants as AGGREGATE COUNTS (total, by country, language and device type, average listening time), ratings (score + comment, no names) and live translation usage per language. Individual listener records are not returned. Params: id (uuid).
get_my_session_ratings
ChatGPTRatings of one of your tours (score + comment + your own report status). Listener names are not returned. Params: id (uuid).
get_my_stats
ChatGPTYour own all-time live tour stats: total tours (sessions), total/average participants, total/average duration in seconds.
get_my_template
ChatGPTDetails of one template: slides, info cards, schedule stops, routes. Params: id (uuid).
get_my_trip
ChatGPTDetails of one trip: stops, info cards, change log and derived progress (day X/Y, completed stops). The participant list is NOT INCLUDED (it needs list_trip_participants + the trips:roster scope). Params: id (uuid).
get_my_trip_ratings
ChatGPTA trip's participant ratings (given after the trip is completed, optional): average, number of raters / participants, 1-5 distribution and comments (newest first). Participant NAMES are NOT returned (trips:roster is not required). Params: id (uuid).
get_website_area
ChatGPTRead ONE root area of the site draft. Params: area (design|content|tours|listings|legal|pages|blog|posts|domain|seo|i18n|social). If there is no draft, value is null; every response also includes the expected shape of that area (shape) -- do not invent field names, follow this shape.
get_website_overview
ChatGPTSummary of the company website: status (draft|published|changes), version, publish date, subdomain + publicUrl, PUBLISH BLOCKERS (blockers: key + fix hint), data counts (trips/programs/ratings/members), LISTING VISIBILITY (listingVisibility: whether each listing appears on the site and, if not, why) and recent versions. Does NOT return the large site JSON; use get_website_area for area contents. The site is published at NO other address than this one; if publicUrl is null there is no address yet.
invite_trip_participant
ChatGPTGenerate and return a SINGLE-USE invite token for an existing participant. Does NOT SEND an email -- you share the link yourself. Params: id (trip uuid), participantId (uuid).
link_collectible_to_template
ChatGPTLink a ready-made magnet chosen from the catalog to a template (without uploading an image). Params: id (template uuid) + body { collectibleId (uuid) }. The target must be ACTIVE and either a ready-made platform magnet OR yours. The previously linked magnet is not deleted, only unlinked. For the catalog use list_collectible_catalog (content:read).
list_collectible_catalog
ChatGPTSouvenir magnet (collectible) catalog: ready-made platform magnets + your own magnets. Filters: search, category, country, city, tag, owner (platform|mine).
list_my_departures
ChatGPTHistory of PAST live tour runs grouped by run (how many sessions and participants each repeat run had). It does NOT list scheduled or upcoming trips; for upcoming departures, dates, capacity and spots left use list_my_trips.
list_my_programs
ChatGPTYour travel programs (itineraries / draft trip plans) + the ones your company shares.
list_my_ratings
ChatGPTRatings listeners left after your live tour sessions (feed across all your sessions; trip ratings come from get_my_trip_ratings). Listener names are not returned. Filters: minRating, maxRating (1-5), hasComment ('true'|'false'), flagged ('true'|'false'), search, dateFrom, dateTo (YYYY-MM-DD), sort (newest|oldest|highest|lowest). Pagination: page/limit.
list_my_sessions
ChatGPTList your own completed tours (sessions), newest first, up to 500: name, date, duration, online/local, participant counts, slides and stops shown, rating average and count. No listener records.
list_my_templates
ChatGPTYour tour templates (+ org templates your active company shares with you). Filters: q, category, country, city, hasCollectible.
list_my_trips
ChatGPTList your trips: the scheduled departures of your programs (upcoming, active and past), each with dates, status (draft|active|completed|cancelled), capacity (maxParticipants, null = unlimited) and participantCount. Use this for questions about upcoming departures, availability or spots left (spots left = maxParticipants - participantCount).
publish_trip
ChatGPTPUBLISH a draft trip (draft -> active): the trip is listed on the company website and opens for booking. NO notification is sent to participants (it is not an announcement). Params: id (trip uuid). Works only on a draft trip.
publish_website
ChatGPTPUBLISH the site draft (a version record is created, the public site is updated, the edge cache is purged). Owner/manager only. Params: label (optional version label). If there are publish blockers, VALIDATION_ERROR with a details.missing list is returned (keys are the same as get_website_overview.blockers). On success publicUrl is returned; the site is live ONLY at this address.
remove_trip_participant
ChatGPTRemove a participant from a trip (status='removed'). Params: id (trip uuid), participantId (uuid).
reorder_program_info_cards
ChatGPTReorder program info cards. Params: id (uuid) + body { cardIds: [...] }.
reorder_program_items
ChatGPTReorder program stops. Params: id (uuid) + body { itemIds: [...] } -- ALL item ids, in the new order, without duplicates.
reorder_slides
ChatGPTReorder slides. Params: id (uuid) + body { slideIds: [...] } -- ALL slide ids of the template, in the new order, without duplicates.
reorder_template_info_cards
ChatGPTReorder info cards. Params: id (uuid) + body { ids: [...] } -- ALL card ids, in the new order.
reorder_template_schedule_stops
ChatGPTReorder schedule stops. Params: id (uuid) + body { ids: [...] } -- ALL stop ids, in the new order.
reorder_trip_items
ChatGPTReorder trip stops. Params: id (uuid) + body { itemIds: [...] } -- ALL item ids, in the new order. NO notification is sent.
set_template_visibility
ChatGPTSwitch a template between personal <-> company-shared. Params: id (uuid) + body { visibility: personal|org }. org only for a company owner/manager. Only changes who can see it INSIDE your own Your Next Tours company workspace; nothing becomes public and nothing is sent outside the account.
set_trip_item_status
ChatGPTRecord the on-site status of a trip stop: done | cancelled | skipped. Params: id (trip uuid), itemId (uuid) + body { status }. NO notification is sent (a stop cancellation announcement requires trips:announce).
set_website_subdomain
ChatGPTClaim or change the site's subdomain: the site is published at https://<subdomain>.yournext.tours. Params: subdomain (lowercase letters, digits, hyphens; 3-63 characters). A reserved/invalid name returns VALIDATION_ERROR (details.reason), a taken name returns CONFLICT. Owner/manager only. A custom domain (your own domain) is connected from the panel.
translate_website
ChatGPTTranslate the site draft into target languages with AI and mark those languages PUBLISHED (same field list and same stored shape as the panel Languages tab). Params: languages (BCP-47 codes, e.g. ['en','de']; excluding the site's default language), groups (optional: content|tours|faq|programs|pages|posts|legal|messaging; empty = all), onlyMissing (default true: skips translations whose hash is current -> spends no credit). Deducted from translation credit (402 on insufficient balance). Shell texts (buttons, headings) are already available in 26 languages; this tool translates ONLY the company's content. To change the default language use update_website_area(i18n).
unlink_template_collectible
ChatGPTRemove a template's magnet link. Params: id (template uuid). Does NOT DELETE the PLATFORM magnet, only detaches it from the template.
unpublish_website
ChatGPTUnpublish the site (the public site returns 404; the draft and version history are kept). Owner/manager only.
update_program
ChatGPTUpdate program metadata. Params: id (uuid) + body (the create fields, all optional). Changing visibility (personal|org) is allowed only for the program's CREATOR. Visibility only controls access INSIDE your own Your Next Tours company workspace; programs never become public through this tool and nothing is sent outside the account.
update_program_info_card
ChatGPTUpdate a program info card. Params: id (program uuid), cardId (uuid) + body { kind, title, body }.
update_program_item
ChatGPTUpdate a program stop. Params: id (program uuid), itemId (uuid) + body (label/dayNumber/notes/kind/startTime/location*/durationMin/headsetPolicy). headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
update_slide_caption
ChatGPTUpdate a slide's caption/text. Params: id (template uuid), slideId (uuid) + body { caption } (null = clear).
update_template
ChatGPTUpdate template metadata. Params: id (uuid) + body (the create fields except visibility, all optional; category/country/city/region/routerProfileId null = clear). visibility is not accepted here and is dropped silently; change it with set_template_visibility.
update_template_info_card
ChatGPTUpdate an info card. Params: id (template uuid), cardId (uuid) + body (title/description/triggerType/linkedScheduleStopId).
update_template_schedule_stop
ChatGPTUpdate a schedule stop. Params: id (template uuid), stopId (uuid) + body (title/description/estimatedTime/latitude/longitude/headsetPolicy/...). headsetPolicy (null clears) = { level: required|recommended|optional, groupThreshold? (int 1..500, applies to groups LARGER than this), reason (1..300, short rule summary or rationale, in the content's language), sourceUrl? (https only; REQUIRED when level=required), sourceLabel? (1..120) }. Only set level=required when a written rule exists and you have its https source; never invent rules.
update_trip
ChatGPTUpdate trip metadata. Params: id (uuid) + body { name, startDate, endDate (YYYY-MM-DD), maxParticipants (null = unlimited), timezone (IANA name, e.g. 'Europe/Istanbul'), weatherCardsEnabled (boolean, turns the trip's weather cards on or off), stableLiveCode (boolean, keeps the same live broadcast link and join code for the whole trip; the code itself is assigned by the server) }. startDate/endDate/maxParticipants/timezone accept null to clear. NO notification is sent to participants.
update_trip_item
ChatGPTUpdate a trip stop. Params: id (trip uuid), itemId (uuid) + body (same fields as add_trip_item; headsetPolicy null clears). NO notification is sent.
update_website_area
ChatGPTChange ONE root area of the site draft. For OBJECT areas (design/content/tours/legal/seo/...) value is MERGED with the current value: send only the keys you change, the ones you do not send stay EXACTLY as they are; nested objects merge too, ARRAYS (gallery, faq, layout, custom...) are written in full exactly as given, and null clears a field. To deliberately replace the whole area, pass replace:true. For ARRAY areas (listings/pages/posts) the whole array is written: first read it with get_website_area, modify it, then write ALL of it back; a write that drops an existing item (by programId for listings, id for pages/posts) is REJECTED unless replace:true (use replace:true only when the user asked to delete). Params: area + value (array for listings/pages/posts, object for the others) + optional replace + optional version (optimistic lock; if stale you get CONFLICT and details.version gives the current version). Image FIELDS accept only a URL reference (existing /uploads or https); a new image is first uploaded with upload_website_image and the returned image object is written here. legal.siteTermsAcceptedAt cannot be written here (panel only). Publishing is a SEPARATE step (publish_website). Keep each write to what the user asked for: template, headerStyle, font and the color palette change the whole look, so they stay as they are unless the user asks. A request that shape cannot express is not supported yet; say so instead of approximating it with other fields. The response's changes summarizes what was written; changes.warning is set when the write removed existing data, which needs restoring unless the user asked for the removal. The tool does not render the page, so its response cannot confirm how the page looks; report the values written and ask the user to check the page.
upload_website_image
ChatGPTUpload an IMAGE to the site (logo/favicon/cover/gallery/promo/past tour/post/destination). Params: kind (logo|favicon|hero|gallery|promo|past|post|destination), alt (short description), and ONE source: imageBase64 (JPEG/PNG/WebP, up to ~5 MB) OR sourceUrl (https; fetched by the server, private/internal networks are rejected). The image is re-encoded (EXIF stripped) and returned as SiteImage {url, alt, width, height} -> write it to the relevant field with update_website_area (e.g. design.logo, content.heroImage, content.gallery[], content.destinations.custom[i].image).