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
GuidesAPI Reference
GuidesAPI Reference
  • Getting started
    • Introduction
    • IP Whitelisting
    • Obtaining API keys
    • LLMs.txt
    • MCP server
    • Quickstart
    • Native clients
    • Concepts
    • Embedding authentication
    • Versioning
    • Idempotent requests
    • Events
    • Self-hosted option
    • 2025-09-18 Migration Guide
  • Configuring your connections
    • Overview
    • CDC streaming from databases
    • Syncing to custom webhooks
  • Code examples
    • Overview
    • 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 Snowflake query to Salesforce
    • Model sync (Reverse ETL) from MongoDB to Salesforce
    • Adding users from Snowflake to Salesloft Cadence
    • Adding contacts from Snowflake to Gong Engage
    • Joined model sync from Postgres, Airtable, and Stripe to Hubspot
    • Model sync from MySQL to Snowflake
    • Model sync from Salesforce to Netsuite
    • Querying Salesforce using SOQL
    • Syncing audiences from Snowflake to LinkedIn Ads
    • Syncing contacts from Google Cloud Storage to Salesforce
    • Syncing contacts from Google Cloud Storage to webhooks
  • Terraform examples
    • Overview
    • Model sync (Reverse ETL) from BigQuery to Salesforce
    • Model sync (Reverse ETL) from BigQuery to LinkedIn Ads
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