{"openapi":"3.1.0","info":{"title":"Tiqstar","version":"1.0.0","description":"Run your Tiqstar events by chatting: create events and tickets, check sales, message guests and more. Call getStarted first, then findActions to look up what to run."},"servers":[{"url":"https://tiqstar.com"}],"externalDocs":{"url":"https://tiqstar.com/ai-assistants"},"paths":{"/api/v1/ai/start":{"get":{"operationId":"getStarted","summary":"Call first. Who the person is, what this connection may do, the areas of Tiqstar available, useful links and how to work.","x-openai-isConsequential":false,"responses":{"200":{"description":"The result, as JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/ai/actions":{"get":{"operationId":"findActions","summary":"Search everything that can be done on the person’s Tiqstar account. Returns matching actions with their exact input schemas, ready to run.","x-openai-isConsequential":false,"parameters":[{"name":"query","in":"query","required":true,"description":"What the person wants, in plain words: \"create an event\", \"ticket sales this week\", \"approve guests\".","schema":{"type":"string"}},{"name":"area","in":"query","required":false,"description":"Optional: only actions in this area (from get_started), e.g. \"Events\", \"Promotions\".","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Optional: only reads, or only changes.","schema":{"type":"string","enum":["read","change"]}},{"name":"limit","in":"query","required":false,"description":"How many matches to return (default 8).","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"The result, as JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/ai/actions/read":{"post":{"operationId":"runReadAction","summary":"Run an action that only reads (kind \"read\" in find_actions): list events, see sales, look up guests. Changes nothing.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","description":"The action name from find_actions, e.g. \"events_create_event\"."},"input":{"type":"object","description":"The action’s input, matching its schema from find_actions: path and query values at the top level, the request body under \"body\".","additionalProperties":true}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"The result, as JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/ai/actions/change":{"post":{"operationId":"runChangeAction","summary":"Run an action that changes something (kind \"change\"): create or edit events and tickets, publish, message guests. Say what you are about to do first; destructive actions also need confirm: true after the person agrees.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","description":"The action name from find_actions, e.g. \"events_create_event\"."},"input":{"type":"object","description":"The action’s input, matching its schema from find_actions: path and query values at the top level, the request body under \"body\".","additionalProperties":true},"confirm":{"type":"boolean","description":"Set true only after the person explicitly agreed to a destructive action (cancel, delete, refund…)."}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"The result, as JSON.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"components":{"schemas":{},"securitySchemes":{"tiqstarSignIn":{"type":"oauth2","description":"Sign in to Tiqstar and approve the connection.","flows":{"authorizationCode":{"authorizationUrl":"https://tiqstar.com/api/v1/oauth/authorize","tokenUrl":"https://tiqstar.com/api/v1/oauth/token","scopes":{"events:read":"See your events, drafts, venues, calendars and event pages","events:write":"Create, edit, publish, reschedule and cancel events","tickets:read":"See ticket types, prices, waitlists and your own tickets","tickets:write":"Create and change ticket types, prices and complimentary tickets","orders:read":"See orders for your events and their receipts","orders:write":"orders:write","attendees:read":"See guest lists, contacts, registrations and invites","attendees:write":"Approve registrations, send invites and update guests and contacts","checkin:read":"See door numbers","checkin:write":"Check guests in and undo check-ins","promotions:read":"See promo codes, affiliates and loyalty programmes","promotions:write":"Create and change promo codes, affiliates and loyalty rewards","insights:read":"See sales, revenue, analytics and reports","insights:write":"insights:write","messages:read":"See your event updates and newsletters","messages:write":"Write and send event updates and newsletters to your guests","team:read":"See co-hosts and crew","team:write":"Invite co-hosts and crew and change what they can do","payouts:read":"See your balance, transactions and payouts (money only ever moves when you do it on Tiqstar)","payouts:write":"payouts:write","merch:read":"See merch products and orders","merch:write":"Create products and update fulfilment","profile:read":"See your organiser profile","profile:write":"Update your organiser profile","support:read":"See your support requests","support:write":"Send feedback and support requests to Tiqstar"}}}},"tiqstarKey":{"type":"http","scheme":"bearer","description":"A personal API key from Tiqstar (Creator → Developer), as tqs_…:tqs_secret_…"}}},"security":[{"tiqstarSignIn":[]},{"tiqstarKey":[]}]}