For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
  • Getting started
    • Introduction
    • Obtaining API keys
    • Quickstart
    • Native clients
    • Concepts
    • Embedding authentication
    • Versioning
    • Idempotent requests
    • Events
  • Configuring your connections
    • CDC streaming from databases
  • Code examples
    • Bulk sync (ELT) from HubSpot to PostgreSQL
    • Bulk sync (ELT) from Salesforce to S3
    • Bulk sync (ELT) from Salesforce to Snowflake
    • Model sync (Reverse ETL) from MongoDB to Salesforce
  • API Reference
Logo
Log inBook a demo
On this page
  • Overview
  • Specifying an API version
  • Supported versions
Getting started

Versioning

Was this page helpful?
Previous

Idempotent requests

Next
Polytomic Connect current version

2025-09-18

Overview

The Polytomic Connect API is versioned. Version identifiers take the form YYYY-MM-DD and match the release date — for example, 2023-04-25. Breaking changes produce a new version. Older versions remain available for a period of time after a new release.

Requests that do not specify a version default to 2025-09-18. Set a version explicitly so new releases do not affect you.

Specifying an API version

Set the X-Polytomic-Version request header to the version you want — for example, X-Polytomic-Version: 2025-09-18.

$curl --header "X-Polytomic-Version: 2025-09-18" \
>     --header "Authorization: Bearer ${POLYTOMIC_API_KEY}" \
>     https://app.polytomic.com/api/me

Every response includes an X-Polytomic-Version header indicating the version that served the request.

Supported versions

The currently supported versions are:

  • 2025-09-18
  • 2024-02-08
  • 2023-04-25
  • 2022-12-12
  • 2021-05-23