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

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",
    "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), 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.

Show child attributes