---
title: "Connectors"
description: "REST endpoints for connectors. Bearer-auth required."
section: "API"
group: "REST"
order: 22
---

## GET /api/connectors

List connectors

List available connectors. Pass workspace_id to include connection status per connector.

**Query parameters**

- `limit` (optional): Max items per page (1–100, default 100).
- `after` (optional): Keyset cursor — return the page after this row (next page).
- `before` (optional): Keyset cursor — return the page before this row (prev page).
- `ids` (optional): Comma-separated IDs. Narrows results to these IDs within the caller's accessible scope (does not bypass access checks).
- `workspace_id` (optional): Include per-connector connection status for this workspace.
- `enabled` (optional): Filter to enabled (true) or disabled (false) connectors.

**Response**

```json
"any"
```

## GET /api/connectors/{id}

Get connector

**Path parameters**

- `id` (required): The connector's ID or slug.

**Response**

```json
{
  "id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "iconUrl": "string",
  "mcpUrl": "string",
  "oauthScopes": "string",
  "configSchema": {},
  "enabled": "boolean",
  "createdAt": "string"
}
```

## GET /api/connectors/{id}/connect

Initiate connector OAuth

Creates a pending MCP server and returns an OAuth authorization URL.

**Path parameters**

- `id` (required): The connector's ID or slug.

**Query parameters**

- `workspace_id` (required): The workspace the MCP server will belong to.
- `config` (optional): JSON-encoded connector-specific config (URL-encoded).

**Response**

```json
{
  "authorizationUrl": "string",
  "mcpServerId": "string"
}
```