Skip to main content

Breaking changes

This page lists past and planned changes to the EventsAir GraphQL API that may impact integrated applications. While we endeavour to maintain backward compatibility as the API evolves, scenarios may arise that require a breaking change.

This page is intended to provide advanced notice of breaking changes so that developers can plan ahead to test their integrated applications and make any necessary changes.

Planned breaking changes​

Future​

The following changes are planned for release at some point in the future, but have not been scheduled yet. Typically, these are fields that have been deprecated in the GraphQL API. We will update this page with details of when these changes will be completed. If your integrated applications use features in this list, we recommend making changes now to avoid any future incompatibility.

  • The address input field on input type UpdateContactDetailsInput has been deprecated and will be removed in a future release. Please use the new primaryAddress field instead.
  • The field userAccessRights on object type Event has been deprecated and will be removed in a future release. Please use the new accessRights field instead.

Past breaking changes​

The following sections list past releases of changes that may have impacted integrated applications.

2024-06-07​

The following changes are planned for release on 2024-06-05. If your integrated applications use features in this list, we recommend making changes now to avoid any future incompatibility.

  • The type for field InvoiceLineItem.payableItem will be changed PayableItem! to PayableItem
  • The type for field PaymentLineItem.payableItem will be changed PayableItem! to PayableItem

2024-02-15​

  • The limit argument used in various queries to limit the number of items returned will be changed from PositiveInt to PaginationLimit. This will set a maximum value of 2,000 for limit.
  • Various objects will be renamed:
    • FindEventContactsInput will be renamed to FindContactsInput.
    • EventOffice will be renamed to Office.
    • EventTextMessagingService will be renamed to TextMessagingService.
    • EventEmailMessagingService will be renamed to EmailMessagingService.
    • EventOnlinePaymentServices will be renamed to OnlinePaymentServices.
    • EventUserAccessRights will be renamed to UserAccessRights.
    • EventUser will be renamed to EventsAirUser.
    • EventInvoiceConfiguration will be renamed to InvoiceConfiguration.
  • The input type FindEventContactsInput used in the query Event.contacts will be replaced with ContactSearchFilterInput offering richer ways to filter contacts. This will also remove related types EventContactsWhere, EventContactsOrderBy and EventContactOrderByField.
  • The offset argument used in Event.contacts will need to be a multiple of the limit argument, or an error will occur.
  • The type used for Contact.website will be changed from URL to String to cater for instances where the field in EventsAir is not a well-formed URL. This will also be changed for input types used in contact mutations: CreateContactInput.website and UpdateContactDetailsInput.website will be changed from URL to String.