{"openapi":"3.1.0","info":{"title":"Sympla (BYOK) API","version":"0.1.0","description":"Sympla (BYOK) lets an AI assistant read your own Sympla data through the Sympla API with a key you supply (Sympla API token (s_token)). Read-only: 7 tools (list_events, get_event, list_presentations, get_presentation, list_event_orders, get_order, list_presentation_orders). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sympla.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sympla/docs"},"termsOfService":"https://connectorbay.com/byok-sympla/terms"},"servers":[{"url":"https://byok-sympla.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sympla/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_events":{"post":{"operationId":"list_events","summary":"List your Sympla events with name, dates, publication and cancellation flags, category, city and public URL. Cursor pagi","description":"List your Sympla events with name, dates, publication and cancellation flags, category, city and public URL. Cursor paging. Use for \"Which of my Sympla events are published and when do they start\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"published":{"anyOf":[{"enum":["published","not_published","all"],"type":"string"},{"type":"null"}],"default":"published","description":"Which events: published (default), not_published or all.","title":"Published"},"from_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events starting after this local date-time (ISO 8601).","title":"From Date"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"},"field_sort":{"anyOf":[{"enum":["start_date","end_date","name"],"type":"string"},{"type":"null"}],"default":"start_date","description":"Sort field: start_date, end_date or name.","title":"Field Sort"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","description":"Sort direction: asc or desc.","title":"Sort"},"page_size":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Items per page (1 to 200).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor taken from pagination.next_cursor of the previous page.","title":"Cursor"}},"title":"list_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_event":{"post":{"operationId":"get_event","summary":"Get one Sympla event: name, dates, category, venue city, host name, publication state and URL. Use for \"What are the det","description":"Get one Sympla event: name, dates, category, venue city, host name, publication state and URL. Use for \"What are the details of my Sympla event abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"}},"required":["event_id"],"title":"get_eventArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_presentations":{"post":{"operationId":"list_presentations","summary":"List the presentations (dates or sessions) of an event with open/closed state and ticket sectors. Use for \"Which session","description":"List the presentations (dates or sessions) of an event with open/closed state and ticket sectors. Use for \"Which sessions does my Sympla event abc123 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"published":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True (default) to list only published presentations.","title":"Published"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","description":"Sort direction: asc or desc.","title":"Sort"},"page_size":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Items per page (1 to 200).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor taken from pagination.next_cursor of the previous page.","title":"Cursor"}},"required":["event_id"],"title":"list_presentationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_presentation":{"post":{"operationId":"get_presentation","summary":"Get one presentation of an event: dates, flags and the ticket sectors with their online sale availability. Use for \"Is t","description":"Get one presentation of an event: dates, flags and the ticket sectors with their online sale availability. Use for \"Is the Sympla session 1234567 of event abc123 still on sale\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"presentation_id":{"description":"Id of one presentation (a date or session) of the event, as returned by list_presentations.","title":"Presentation Id","type":"integer"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"}},"required":["event_id","presentation_id"],"title":"get_presentationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_event_orders":{"post":{"operationId":"list_event_orders","summary":"List ticket orders of an event with status, dates, discount code and sale and net totals (buyer identity is not returned","description":"List ticket orders of an event with status, dates, discount code and sale and net totals (buyer identity is not returned). Use for \"How many orders did my Sympla event abc123 get this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"},"from_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders from this local date-time (ISO 8601).","title":"From Date"},"to_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders up to this local date-time (ISO 8601).","title":"To Date"},"cancelled_filter":{"anyOf":[{"enum":["none","include","only"],"type":"string"},{"type":"null"}],"default":"none","description":"Cancelled orders: none (default), include or only.","title":"Cancelled Filter"},"field_sort":{"anyOf":[{"enum":["order_date","updated_date","approved_date","status","id"],"type":"string"},{"type":"null"}],"default":"order_date","description":"Sort field: order_date, updated_date, approved_date, status or id.","title":"Field Sort"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction: asc or desc.","title":"Sort"},"page_size":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Items per page (1 to 200).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor taken from pagination.next_cursor of the previous page.","title":"Cursor"}},"required":["event_id"],"title":"list_event_ordersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_order":{"post":{"operationId":"get_order","summary":"Get one ticket order of an event: status, dates, discount code and totals (buyer identity is not returned). Use for \"Wha","description":"Get one ticket order of an event: status, dates, discount code and totals (buyer identity is not returned). Use for \"What is the status and total of Sympla order ABC123XYZ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"order_id":{"description":"Order id (orderSk) from list_event_orders.","maxLength":200,"title":"Order Id","type":"string"}},"required":["event_id","order_id"],"title":"get_orderArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_presentation_orders":{"post":{"operationId":"list_presentation_orders","summary":"List ticket orders of one presentation (session) with status, dates and totals (buyer identity is not returned). Use for","description":"List ticket orders of one presentation (session) with status, dates and totals (buyer identity is not returned). Use for \"What orders did Sympla session 1234567 of event abc123 receive\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Sympla event id (the event hash from the events list, for example 'abc123').","maxLength":200,"title":"Event Id","type":"string"},"presentation_id":{"description":"Id of one presentation (a date or session) of the event, as returned by list_presentations.","title":"Presentation Id","type":"integer"},"timezone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"America/Sao_Paulo","description":"IANA time zone applied to dates sent and returned, for example America/Sao_Paulo (the default).","title":"Timezone"},"cancelled_filter":{"anyOf":[{"enum":["none","include","only"],"type":"string"},{"type":"null"}],"default":"none","description":"Cancelled orders: none (default), include or only.","title":"Cancelled Filter"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","description":"Sort direction: asc or desc.","title":"Sort"},"page_size":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Items per page (1 to 200).","title":"Page Size"},"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor taken from pagination.next_cursor of the previous page.","title":"Cursor"}},"required":["event_id","presentation_id"],"title":"list_presentation_ordersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}