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

# HTTP API

Supports:
* ✅ Models


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auth</code></td>
<td><code>object</code></td>
<td style="vertical-align: top;">Authentication method</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>body</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">JSON payload</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>headers</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Headers</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>healthcheck</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Health check endpoint<br/><br/>Path to request when checking the health of this connection. No health check will be performed if left empty.</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>parameters</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Query string parameters</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>url</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Base URL</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example

```json
{
  "name": "HTTP API connection",
  "type": "api",
  "configuration": {
    "auth": {
        "basic": {
            "password": "secret",
            "username": "user@example.com"
        },
        "header": {
            "name": "foo",
            "value": "bar"
        },
        "oauth": {
            "auth_style": 0,
            "client_id": "client_id",
            "client_secret": "client_secret",
            "extra_form_data": [
                {
                    "name": "foo",
                    "value": "bar"
                }
            ],
            "scopes": [],
            "token_endpoint": "https://example.com/oauth/token"
        },
        "query": [
            {
                "name": "foo",
                "value": "bar"
            }
        ]
    },
    "body": "{\"key\":\"value\"}",
    "headers": [
        {
            "name": "foo",
            "value": "bar"
        }
    ],
    "healthcheck": "https://example.com/healthz",
    "parameters": [
        {
            "name": "foo",
            "value": "bar"
        }
    ],
    "url": "https://example.com"
  }
}
```


## 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>body</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Request body</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>headers</code></td>
<td><code>object</code></td>
<td style="vertical-align: top;">Headers</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>method</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Method<br/><br/>Accepted values: `GET`, `POST`</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>pagination</code></td>
<td><code>object</code></td>
<td style="vertical-align: top;">Pagination</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>parameters</code></td>
<td><code>object</code></td>
<td style="vertical-align: top;">Parameters</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>path</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Path</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>record_path</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Record JSON path</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>sampleResponse</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">API response</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "body": "",
    "headers": {},
    "method": "GET",
    "pagination": {},
    "parameters": {},
    "path": "",
    "record_path": "",
    "sampleResponse": ""
  }
}
```