> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

To make requests against the Polytomic API, you need an API key.
Generate one from your Polytomic [settings panel](https://app.polytomic.com/settings/user)
and pass it in the `Authorization` header.

## Example

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

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

To validate the key, call the identity endpoint:

```shell
curl --request GET \
     --url https://app.polytomic.com/api/me \
     --header 'accept: application/json' \
     --header 'X-Polytomic-Version: 2024-02-08' \
     --header 'Authorization: Bearer 8e5dcfdd-d23d-4e6f-a136-119e1254847b'
```

> **API keys are organization-specific**

## 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](/api-reference/organization/create).
2. Create a [root user](/api-reference/users/create) in that Organization.
3. Use [Create API Key](/api-reference/users/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](mailto:support@polytomic.com).