curl 'https://api.hydradb.com/connectors' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"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"
}
]
}
List Connectors
List all connectors for the authenticated organization.
curl 'https://api.hydradb.com/connectors' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"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"
}
]
}
curl 'https://api.hydradb.com/connectors' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"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
API key sent as a Bearer token: "Bearer prefix.secret"
Query Parameters
Filter by provider
"slack"
Response
OK
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
Show child attributes
{
"count": 12,
"limit": 1,
"message": "Success"
}
Show child attributes
Show child attributes
[
{
"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 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
Show child attributes
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
Show child attributes
{ "message": "Success" }
Was this page helpful?