List Connectors

List all connectors for the authenticated organization.

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",
      "tenant_id": "acme_corp",
      "sub_tenant_id": "engineering",
      "provider_account_scope": "T12345ACME",
      "status": "active",
      "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 all connectors belonging to the organization associated with the API key.

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",
      "tenant_id": "acme_corp",
      "sub_tenant_id": "engineering",
      "provider_account_scope": "T12345ACME",
      "status": "active",
      "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 - fetch a single connector by ID
• Create Connector
• Delete 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

ConnectorLimit is present when the org has used its plan's connector allowance (Free: 3) and the caps mode enforces it: creating another connector is refused with 402. Connectors already past the allowance keep syncing; the limit applies to creating one. Absent otherwise, and sent with the health rollups only.

Show child attributes

Example:

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

connectors · object[]

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_cycles_completed": 1,
    "sync_interval_seconds": 3600,
    "sync_status": "idle",
    "tenant_id": "tenant_1234"
  }
]

health · object

Health maps connector_id to its rollup (healthy | degraded | failed | checking | capped), present only when the caller asks for ?include=health. A connector missing from the map has an unknown rollup — its resources could not be read — which clients must not render as a failure. capped is not a rollup of the connector: it is overlaid on a healthy, degraded or checking one when the org is at a plan cap, and PlanCap says which.

Show child attributes

plan_cap · object

PlanCap is present when the org is at a plan cap the caps mode enforces; every sync is skipped until the month resets or the plan changes.

Show child attributes

Example:

{ "message": "Success" }