> 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.

# Polytomic Metadata

Supports:
* ✅ Models
* ✅ Bulk sync source
* ✅ Connection Proxy


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auth_mode</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Authentication method<br/><br/>Type of API key to use for authentication. Accepted values: `personal_api_key` <a href="#auth-mode-personal-api-key">↓</a>, `partner_api_key` <a href="#auth-mode-partner-api-key">↓</a></td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Read-only property</th><th>Type</th><th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>connected_org</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected organization</td>
</tr>
<tr>
<td><code>connected_user</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected user</td>
</tr>
</tbody>
</table>

<a id="auth-mode-personal-api-key"></a>

#### `auth_mode`

When `auth_mode` is `personal_api_key`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>personal_api_key</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Personal API key<br/><br/>Your personal API key from Polytomic settings</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Polytomic Metadata connection",
  "type": "polytomic_metadata",
  "configuration": {
    "auth_mode": "personal_api_key",
    "personal_api_key": ""
  }
}
```

<a id="auth-mode-partner-api-key"></a>

When `auth_mode` is `partner_api_key`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>partner_api_key</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Partner API key provided by Polytomic</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Polytomic Metadata connection",
  "type": "polytomic_metadata",
  "configuration": {
    "auth_mode": "partner_api_key",
    "partner_api_key": ""
  }
}
```

<a id="auth-mode-deployment-api-key"></a>

When `auth_mode` is `deployment_api_key`:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>deployment_api_key</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Deployment API key</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Polytomic Metadata connection",
  "type": "polytomic_metadata",
  "configuration": {
    "auth_mode": "deployment_api_key",
    "deployment_api_key": ""
  }
}
```



## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>object</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "object": "bulk_sync_executions"
  }
}
```







## Bulk Sync
### Source
Polytomic Metadata connections may be used as a bulk sync source. No additional configuration options are required.