Obtaining API keys

To make requests against the Polytomic API, you need an API key. Generate one from your Polytomic settings panel and pass it in the Authorization header.

Example

With an API key of 8e5dcfdd-d23d-4e6f-a136-119e1254847b, the header is:

Authorization: Bearer 8e5dcfdd-d23d-4e6f-a136-119e1254847b

To validate the key, call the identity endpoint:

$
curl --request GET \
>
     --url https://app.polytomic.com/api/me \
>
     --header 'accept: application/json' \
>
     --header 'X-Polytomic-Version: 2025-09-18' \
>
     --header 'Authorization: Bearer 8e5dcfdd-d23d-4e6f-a136-119e1254847b'

Partner keys

Partner keys are tokens that let you manage your customers’ Organizations. They behave like regular API keys but are limited to the Organization and User endpoints.

A typical workflow:

1. Create a customer Organization.
2. Create a root user in that Organization.
3. Use Create API Key to mint an API key for the Organization.
4. Use that key to create Organization-level resources such as Connections, models, and syncs.

To obtain a partner key, contact the Polytomic team at support@polytomic.com.