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

# Integrations

An integration is one website. It holds the domains the publishable key works on, the key itself, and the snippet to paste into your pages. You can manage integrations in the app or with these endpoints, using your Resemble API key.

| Method  | Path                                     | Purpose                                                  |
| ------- | ---------------------------------------- | -------------------------------------------------------- |
| `GET`   | `/agent_detection/sites`                 | List your integrations.                                  |
| `POST`  | `/agent_detection/sites`                 | Create one. Body: `domain` (required), `name`.           |
| `GET`   | `/agent_detection/sites/{id}`            | Get one, including its publishable key and snippet.      |
| `PATCH` | `/agent_detection/sites/{id}`            | Update `name`, or replace the list of allowed `domains`. |
| `POST`  | `/agent_detection/sites/{id}/rotate_key` | Issue a new publishable key.                             |

All paths are relative to `https://app.resemble.ai/api/v2`.

## Create an integration

```bash
curl --request POST 'https://app.resemble.ai/api/v2/agent_detection/sites' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "domain": "example.com", "name": "Example" }'
```

```json
{
  "success": true,
  "item": {
    "id": 12,
    "name": "Example",
    "domains": ["example.com"],
    "active": true,
    "publishable_key": "pk_live_...",
    "snippet": "<script async src=\"...\" data-resemble-key=\"pk_live_...\" data-resemble-endpoint=\"https://app.resemble.ai/api/v2/agent_detection/telemetry\"></script>",
    "created_at": "2026-09-23T17:00:00Z"
  }
}
```

## Rotate a key

Rotate the publishable key if it was used on a site you do not control. The old key stops working immediately, so update the snippet on your pages with the new key right away.