> ## Documentation Index
> Fetch the complete documentation index at: https://scalehousesystems.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors API

> API endpoints for managing connectors

## Overview

The Connectors API allows you to manage connectors programmatically.

## Endpoints

### Create Activation Token

```bash theme={null}
POST /api/connectors/create-token
```

Generate a new activation token for a connector.

**Response:**

```json theme={null}
{
  "token": "act_abc123...",
  "expires_at": "2024-01-01T12:00:00Z"
}
```

### Activate Connector

```bash theme={null}
POST /api/connectors/activate
```

Activate a connector using an activation token.

**Request:**

```json theme={null}
{
  "token": "act_abc123...",
  "name": "Office Main Computer"
}
```

### List Connectors

```bash theme={null}
GET /api/connectors
```

Get a list of all connectors for your organization.

### Get Connector

```bash theme={null}
GET /api/connectors/{id}
```

Get details about a specific connector.

### Connector Heartbeat

```bash theme={null}
POST /api/connectors/{id}/heartbeat
```

Send a heartbeat to indicate the connector is alive.

## Next Steps

<CardGroup cols={2}>
  <Card title="Ingestion API" icon="upload" href="/docs/docs/api-reference/ingestion">
    Ingest audit events
  </Card>

  <Card title="MCP Tools" icon="code" href="/docs/docs/api-reference/mcp-tools">
    MCP tool reference
  </Card>
</CardGroup>
