AI client tool reference
Every TixFin tool that maps to one organiser API operation, with its permission, operations and whether it needs personal data
This page lists every tool that calls one operation of the TixFin organiser API, generated from TixFin's tool manifest; the titles are the API's. A tool needs the permission of its section on the consent page. A tool that changes something answers with a proposal and changes nothing until you confirm it. Tools TixFin answers itself, such as event_plan, proposal_apply and api_call, are described on What your AI client can do.
A tool marked yes under Personal data also needs See buyers' personal data.
Read (tixfin.read)
| Tool | Title | Operations | Personal data |
|---|---|---|---|
attendance_get | List attendance events for an event, newest first | GET /projects/{projectId}/events/{eventId}/attendance | yes |
attribution_links_list | List tracking links with their visits, orders and revenue | GET /projects/{projectId}/attribution/links | yes |
campaign_preview | Preview resolved recipients before sending | POST /projects/{projectId}/email-campaigns/preview | yes |
campaign_templates_list | List templates visible for project (global + project + event) | GET /projects/{projectId}/email-campaigns/templates | yes |
checkin_lists_list | List check-in lists for an event | GET /projects/{projectId}/events/{eventId}/check-in-lists | yes |
event_get | Get a project event by id | GET /projects/{projectId}/events/{eventId} | β |
events_attendance | List attendance counts for events in the project | GET /projects/{projectId}/events/attendance | β |
events_list | List events for a project (paginated) | GET /projects/{projectId}/events | β |
events_wizard_presets | List event wizard presets | GET /projects/{projectId}/events/wizard-presets | β |
group_discounts_list | List the project's active group discounts (quantity breaks) | GET /projects/{projectId}/group-discounts | β |
guest_list_links_list | List the event's guest-list signup links with their counts | GET /projects/{projectId}/events/{eventId}/guest-list-links | yes |
journeys_list | List a project's journeys | GET /projects/{projectId}/journeys | yes |
lotteries_list | List lotteries for event | GET /projects/{projectId}/events/{eventId}/lotteries | yes |
newsletter_sync_status | Read the latest lines of the newsletter sync log | GET /projects/{projectId}/newsletter-integration/log | yes |
order_get | Get an order's lines, notes and ledger-derived balance | GET /projects/{projectId}/orders/{orderId} | yes |
orders_list | List a project's orders | GET /projects/{projectId}/orders | yes |
packages_list | List a project's package definitions, optionally filtered by season | GET /projects/{projectId}/packages | β |
products_list | List a project's products | GET /projects/{projectId}/products | β |
project_get | Gibt ein einzelnes Projekt zurΓΌck | GET /projects/{id} | yes |
report_export | Run a saved report definition and download it as CSV, XLSX or PDF | GET /projects/{projectId}/report-definitions/{reportDefinitionId}/export | yes |
reports_list | List a project's saved report definitions (paged) | GET /projects/{projectId}/report-definitions | yes |
sales_heatmap | A project's sales by date and time slot | GET /projects/{projectId}/analytics/sales-heatmap | β |
sales_summary | An event's sales by ticket type and day | GET /projects/{projectId}/events/{eventId}/sales-summary | β |
seatmap_get | Get the full seatmap layout (seatmap + sections + seats) | GET /projects/{projectId}/venues/{venueId}/seatmaps/{seatmapId}/layout | β |
seatmap_templates_list | List global seatmap templates for a project | GET /projects/{projectId}/venues/{venueId}/seatmaps/global-templates | β |
seatmap_validate | Validate the seatmap layout server-side (errors, warnings, hints) | GET /projects/{projectId}/venues/{venueId}/seatmaps/{seatmapId}/validate | β |
shop_customization_get | Get current shop customization for admin editing | GET /projects/{projectId}/shop/customization | β |
shop_pages_list | List shop pages for admin editing | GET /projects/{projectId}/shop/pages | β |
tiers_list | List ticket tiers for an event (effective by default) | GET /tiers/projects/{projectId}/events/{eventId}/tiers | β |
venues_list | List venues for a project (paginated) | GET /projects/{projectId}/venues | β |
Changes you confirm (tixfin.write)
| Tool | Title | Operations | Personal data |
|---|---|---|---|
attribution_link_archive | Archive a tracking link | POST /projects/{projectId}/attribution/links/{linkId}/archive | yes |
attribution_link_create | Create a tracking link | POST /projects/{projectId}/attribution/links | yes |
campaign_draft | Create a new email template; Update an email template | POST /projects/{projectId}/email-campaigns/templatesPUT /projects/{projectId}/email-campaigns/templates/{templateId} | yes |
event_create | Create a project event | POST /projects/{projectId}/events | β |
event_resume_sales | Resume sales for a postponed event | POST /projects/{projectId}/events/{eventId}/resume-sales | β |
event_update | Update a project event | PUT /projects/{projectId}/events/{eventId} | β |
journey_upsert | Create a journey; Update a journey's name, trigger or active flag | POST /projects/{projectId}/journeysPUT /projects/{projectId}/journeys/{journeyId} | yes |
lottery_upsert | Create lottery; Update | POST /projects/{projectId}/events/{eventId}/lotteriesPUT /projects/{projectId}/events/{eventId}/lotteries/{lotteryId} | yes |
report_run | Run a saved report definition now and return its computed rows | POST /projects/{projectId}/report-definitions/{reportDefinitionId}/execute | yes |
seatmap_publish | Validate and publish a seatmap, snapshotting it into a new revision | POST /projects/{projectId}/venues/{venueId}/seatmaps/{seatmapId}/publish | β |
shop_page_upsert | Create a shop page; Update a shop page | POST /projects/{projectId}/shop/pagesPUT /projects/{projectId}/shop/pages/{pageId} | β |
ticket_type_create | Create a ticket type for an event | POST /projects/{projectId}/events/{eventId}/ticket-types | β |
tier_upsert | Create an event-scoped ticket tier; Update an event-scoped ticket tier | POST /tiers/projects/{projectId}/events/{eventId}/tiersPUT /tiers/projects/{projectId}/events/{eventId}/tiers/{tierId} | β |
venue_upsert | Create a venue; Update a venue | POST /projects/{projectId}/venuesPUT /projects/{projectId}/venues/{venueId} | β |
A change above is a money proposal, which needs Take actions that move money or reach buyers and a second factor from the last ten minutes, when:
event_update: the request setsrefundEnabled; the request setsrefundFeePercent; the request setsrefundCutoffMinutes; the request setsstartsAt; the request setsseatmapId; the request setsvenueCountryticket_type_create:eventIdnames one that exists already, not one the same proposal creates
Money and buyers (tixfin.money, with a fresh second factor)
| Tool | Title | Operations | Personal data |
|---|---|---|---|
campaign_send | Send campaign email to resolved recipients | POST /projects/{projectId}/email-campaigns/send | yes |
event_cancel | Cancel an event and pause sales | POST /projects/{projectId}/events/{eventId}/cancel | β |
event_delete | Delete a project event | DELETE /projects/{projectId}/events/{eventId} | β |
event_postpone | Postpone an event and pause sales | POST /projects/{projectId}/events/{eventId}/postpone | β |
external_admissions_import | Import barcodes of tickets sold elsewhere, or check them with a dry run | POST /projects/{projectId}/events/{eventId}/external-admissions/import | yes |
group_discount_create | Create a group discount: from minQuantity tickets of one type in an order, each pays the reduced price | POST /projects/{projectId}/group-discounts | β |
group_discount_delete | Switch a group discount off | DELETE /projects/{projectId}/group-discounts/{discountId} | β |
guest_list_approve | Approve or reject pending guest-list signups in bulk; each guest is mailed the answer | POST /projects/{projectId}/events/{eventId}/guest-list-signups/decide | yes |
guest_list_link_upsert | Create a capped guest-list signup link, optionally per promoter, with a deadline | POST /projects/{projectId}/events/{eventId}/guest-list-links | yes |
order_exchange | Exchange an order line for a different seat category or performance | POST /projects/{projectId}/orders/{orderId}/exchanges | yes |
order_refund | Refund an order, fully or partially, at the order-line level | POST /projects/{projectId}/orders/{orderId}/refunds | yes |
package_upsert | Create a package definition, with its components and rules; Update a package definition, replacing its components and rules | POST /projects/{projectId}/packagesPUT /projects/{projectId}/packages/{packageId} | β |
product_upsert | Create a product; Update a product | POST /projects/{projectId}/productsPUT /projects/{projectId}/products/{productId} | β |
seatmap_apply_template | Apply a seatmap template and overwrite the full layout | POST /projects/{projectId}/venues/{venueId}/seatmaps/{seatmapId}/apply-template/{templateSeatmapId} | β |
shop_customization_update | Save shop customization (does not publish) | PUT /projects/{projectId}/shop/customization | β |