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"
}
]
}
Connectors
List Connectors
List all connectors for the authenticated organization.
GET
/
connectors
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"
}
]
}
Returns all connectors belonging to the organization associated with the API key.
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
Example:
"slack"
Response
OK
Show child attributes
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 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
Show child attributes
Was this page helpful?