List Connectors

List every connector in your workspace.

GET /connectors

cURL

curl 'https://api.hydradb.com/connectors' \
  -H "Authorization: Bearer $HYDRA_DB_API_KEY" \
  -H "API-Version: 2"

200

{
  "connectors": [
    {
      "connector_id": "{connector_id}",
      "provider": "slack",
      "name": "acme-engineering",
      "database": "acme_corp",
      "collection": "engineering",
      "tenant_id": "acme_corp",
      "sub_tenant_id": "engineering",
      "provider_account_scope": "T12345ACME",
      "lifecycle": "active",
      "sync_status": "idle",
      "active_resource_count": 2,
      "sync_interval_seconds": 3600,
      "next_sync_at": "2026-06-01T13:00:00Z",
      "last_successful_sync_at": "2026-06-01T12:05:00Z",
      "last_attempted_sync_at": "2026-06-01T12:05:00Z"
    }
  ]
}

Returns every connector in the workspace your API key belongs to. Pass provider to list only one provider’s connectors, for example ?provider=slack.

Each entry has the same fields as Get Connector. Read lifecycle for what a connector is doing, and use Get Connector Status when you need per-resource health.

cURL

curl 'https://api.hydradb.com/connectors' \
  -H "Authorization: Bearer $HYDRA_DB_API_KEY" \
  -H "API-Version: 2"

200

{
  "connectors": [
    {
      "connector_id": "{connector_id}",
      "provider": "slack",
      "name": "acme-engineering",
      "database": "acme_corp",
      "collection": "engineering",
      "tenant_id": "acme_corp",
      "sub_tenant_id": "engineering",
      "provider_account_scope": "T12345ACME",
      "lifecycle": "active",
      "sync_status": "idle",
      "active_resource_count": 2,
      "sync_interval_seconds": 3600,
      "next_sync_at": "2026-06-01T13:00:00Z",
      "last_successful_sync_at": "2026-06-01T12:05:00Z",
      "last_attempted_sync_at": "2026-06-01T12:05:00Z"
    }
  ]
}

Related Resources

• Get Connector: one connector by id
• Get Connector Status: whether a connector is working
• Create Connector

Authorizations

Authorization · string · header · required

API key sent as a Bearer token: "Bearer prefix.secret"

Query Parameters

provider · string

Filter by provider

Example:

"slack"

Response

200

application/json

OK

connector_limit · object

Present when the plan's connector allowance is used up, so creating another returns 402; existing connectors keep syncing. Only with include=health.

Show child attributes

Example:

{
  "count": 12,
  "limit": 1,
  "message": "Success"
}

connectors · object[]

Connectors in your organization.

Show child attributes

Example:

[
  {
    "active_resource_count": 1,
    "auth_type": "api_token",
    "collection": "team_docs",
    "connector_id": "conn_abc123",
    "database": "acme_corp",
    "documents_dispatched": 1,
    "last_attempted_sync_at": "2026-07-02T17:00:00Z",
    "last_error": "",
    "last_successful_sync_at": "2026-07-02T17:00:00Z",
    "name": "general",
    "needs_reauth": true,
    "next_sync_at": "2026-07-02T18:00:00Z",
    "paused": true,
    "provider": "slack",
    "provider_account_scope": "T12345ACME",
    "resources_pending_first_sync": 1,
    "status": "completed",
    "sub_tenant_id": "sub_tenant_4567",
    "sync_blocked": true,
    "sync_interval_seconds": 3600,
    "sync_status": "idle",
    "tenant_id": "tenant_1234"
  }
]

health · object

Health per connector_id: healthy, degraded, failed, checking or capped (at a plan limit, see plan_cap). Only with include=health; missing means unknown.

Show child attributes

plan_cap · object

Present when the organization is at a plan limit, so connector syncs are skipped until usage resets or the plan changes. Only with include=health.

Show child attributes

Example:

{ "message": "Success" }