DocumentationAPI Reference
API Reference

Versioning

Follow changes to the Prequel API and manage versions in your requests.

Prequel releases API versions, each identified by a date, to introduce backwards-incompatible changes that might affect existing integrations. The first new version of the Prequel API is 2023-12-01.

Some API changes shouldn’t break existing integrations. For example, we don’t consider additive changes (new endpoints, new optional parameters, new enum values, etc) to be breaking changes. When this type of change is introduced, Prequel will add it to all active versions.

Current versions

The available versions of the Prequel API are 2023-12-01 and 2022-01-01 ( 2022-01-01 is the base version and the current default). We recommend new users build against 2023-12-01. Both versions are actively maintained. If you are an existing developer, we will reach out to you directly regarding migration plans and timelines.

What's new in 2023-12-01

Updates to the destination object

We renamed fields on destinations where the database vendor uses proprietary terminology. For example, the field username on Amazon Athena has changed to workgroup.

We've added enum values and reorganized nested objects in order to clarify conditional dependencies between fields. We may update other endpoints similarly based on feedback.

Pagination

List endpoints support pagination in 2023-12-01.

Status code when testing connection

The destination test-connection endpoints return a top-level status code of success in 2023-12-01 if the request was well-formed, regardless of whether the test passed.

Upgrading your version

You can set the x-prequel-api-version header to specify the API version per-request.

curl --request GET \
     --url https://api.prequel.co/destinations \
     --header 'X-PREQUEL-API-VERSION: ‘2023-12-01`  

If no version is specified, the current base (2022-01-01) will be used.

Prequel SDKs

The Prequel SDKs use the base version.