{"openapi":"3.1.0","info":{"title":"Eventbrite (BYOK) API","version":"0.1.0","description":"Eventbrite (BYOK) lets an AI assistant read your own Eventbrite data through the Eventbrite API with a key you supply (private token (personal OAuth token)). Read-only: 10 tools (get_me, list_my_organizations, list_organization_events, get_event, list_event_attendees, list_event_orders, list_organization_orders, list_ticket_classes, list_organization_venues, list_venue_events). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-eventbrite.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-eventbrite/docs"},"termsOfService":"https://connectorbay.com/byok-eventbrite/terms"},"servers":[{"url":"https://byok-eventbrite.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-eventbrite/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/get_me":{"post":{"operationId":"get_me","summary":"Show the Eventbrite account the private token belongs to: as returned by Eventbrite (the shape of this object is not ite","description":"Show the Eventbrite account the private token belongs to: as returned by Eventbrite (the shape of this object is not itemised in the docs, so it is passed through whole). Use for \"Which Eventbrite account is my token for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","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_my_organizations":{"post":{"operationId":"list_my_organizations","summary":"List the organizations the account belongs to with id, name and vertical. The organization id is needed for the event, o","description":"List the organizations the account belongs to with id, name and vertical. The organization id is needed for the event, order and venue tools. Use for \"Which Eventbrite organizations do I belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"title":"list_my_organizationsArguments","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_organization_events":{"post":{"operationId":"list_organization_events","summary":"List an organization's events with name, dates, status, capacity and URL, filtered by status and time. Paged by continua","description":"List an organization's events with name, dates, status, capacity and URL, filtered by status and time. Paged by continuation token. Use for \"What live Eventbrite events do I have coming up\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Eventbrite organization ID (get it from list_my_organizations), for example '1234567890'.","maxLength":30,"title":"Organization Id","type":"string"},"status":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":"live","description":"Event status: draft, live, started, ended, completed, canceled, all (a comma-separated list is also accepted).","title":"Status"},"time_filter":{"anyOf":[{"enum":["all","past","current_future"],"type":"string"},{"type":"null"}],"default":"all","description":"Limit to all, past or current_future events.","title":"Time Filter"},"order_by":{"anyOf":[{"enum":["start_asc","start_desc","created_asc","created_desc","name_asc","name_desc"],"type":"string"},{"type":"null"}],"default":"start_asc","description":"Sort order: start_asc, start_desc, created_asc, created_desc, name_asc or name_desc.","title":"Order By"},"name_filter":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only events whose name matches this text.","title":"Name Filter"},"page_size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many events per page (default 50).","title":"Page Size"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["organization_id"],"title":"list_organization_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 event: name, summary, dates and time zone, status, currency, capacity, online flag and URL. Use for \"What are th","description":"Get one event: name, summary, dates and time zone, status, currency, capacity, online flag and URL. Use for \"What are the details of Eventbrite event 1234567890\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Eventbrite event ID, the number in the event URL, for example '1234567890'.","maxLength":30,"title":"Event Id","type":"string"}},"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_event_attendees":{"post":{"operationId":"list_event_attendees","summary":"List the attendees (one per ticket) of an event with status, check-in flag, ticket class, order and the attendee's name ","description":"List the attendees (one per ticket) of an event with status, check-in flag, ticket class, order and the attendee's name and email. Contains personal data of ticket holders. Use for \"Who is attending Eventbrite event 1234567890\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Eventbrite event ID, the number in the event URL, for example '1234567890'.","maxLength":30,"title":"Event Id","type":"string"},"status":{"anyOf":[{"enum":["attending","not_attending","unpaid"],"type":"string"},{"type":"null"}],"default":null,"description":"Attendee status: attending, not_attending or unpaid.","title":"Status"},"changed_since":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only attendees changed on or after this ISO 8601 time, for example 2026-01-01T00:00:00Z.","title":"Changed Since"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["event_id"],"title":"list_event_attendeesArguments","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 the orders placed for an event with status, buyer name and email, totals and dates. Contains personal data of buyer","description":"List the orders placed for an event with status, buyer name and email, totals and dates. Contains personal data of buyers. Use for \"Which orders were placed for Eventbrite event 1234567890\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Eventbrite event ID, the number in the event URL, for example '1234567890'.","maxLength":30,"title":"Event Id","type":"string"},"status":{"anyOf":[{"enum":["active","inactive","both","all_not_deleted"],"type":"string"},{"type":"null"}],"default":"active","description":"Order status filter: active, inactive, both or all_not_deleted.","title":"Status"},"changed_since":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders changed on or after this ISO 8601 time, for example 2026-01-01T00:00:00Z.","title":"Changed Since"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"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/list_organization_orders":{"post":{"operationId":"list_organization_orders","summary":"List orders across all events of an organization with status, buyer, event, totals and dates. Contains personal data of ","description":"List orders across all events of an organization with status, buyer, event, totals and dates. Contains personal data of buyers. Use for \"What orders did my Eventbrite organization receive recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Eventbrite organization ID (get it from list_my_organizations), for example '1234567890'.","maxLength":30,"title":"Organization Id","type":"string"},"status":{"anyOf":[{"enum":["active","inactive","both","all_not_deleted"],"type":"string"},{"type":"null"}],"default":"active","description":"Order status filter: active, inactive, both or all_not_deleted.","title":"Status"},"changed_since":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders changed on or after this ISO 8601 time, for example 2026-01-01T00:00:00Z.","title":"Changed Since"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["organization_id"],"title":"list_organization_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/list_ticket_classes":{"post":{"operationId":"list_ticket_classes","summary":"List an event's ticket types with name, price, fee, capacity, number sold, sales window and on-sale status. Use for \"Wha","description":"List an event's ticket types with name, price, fee, capacity, number sold, sales window and on-sale status. Use for \"What ticket types does Eventbrite event 1234567890 sell and how many are sold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Eventbrite event ID, the number in the event URL, for example '1234567890'.","maxLength":30,"title":"Event Id","type":"string"},"category":{"anyOf":[{"enum":["all","admission","add_on","donation"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit to admission, add_on, donation or all ticket classes.","title":"Category"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["event_id"],"title":"list_ticket_classesArguments","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_organization_venues":{"post":{"operationId":"list_organization_venues","summary":"List an organization's venues with name, address, coordinates and capacity. Use for \"Which venues does my Eventbrite org","description":"List an organization's venues with name, address, coordinates and capacity. Use for \"Which venues does my Eventbrite organization use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Eventbrite organization ID (get it from list_my_organizations), for example '1234567890'.","maxLength":30,"title":"Organization Id","type":"string"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["organization_id"],"title":"list_organization_venuesArguments","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_venue_events":{"post":{"operationId":"list_venue_events","summary":"List the events held at one venue with name, dates and status. Use for \"What events happen at Eventbrite venue 7\".","description":"List the events held at one venue with name, dates and status. Use for \"What events happen at Eventbrite venue 7\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"venue_id":{"description":"Eventbrite venue ID (from list_organization_venues), for example '7'.","maxLength":30,"title":"Venue Id","type":"string"},"status":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":"live","description":"Event status: draft, live, started, ended, completed, canceled, all.","title":"Status"},"only_public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to list public events only.","title":"Only Public"},"continuation":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: the pagination.continuation value of the previous answer (leave empty for the first page).","title":"Continuation"}},"required":["venue_id"],"title":"list_venue_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}}}}