curl 'https://api.hydradb.com/connectors/{id}/resources' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"resources": [
{
"connector_id": "{connector_id}",
"resource_id": "{resource_id}",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
Connectors
List Connector Resources
List configured resources and their sync state.
GET
/
connectors
/
{id}
/
resources
curl 'https://api.hydradb.com/connectors/{id}/resources' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"resources": [
{
"connector_id": "{connector_id}",
"resource_id": "{resource_id}",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
Returns all resources configured on a connector and their current sync state. Poll
Use
provider_cursor after triggering a sync - a non-empty value confirms the sync ran.
curl 'https://api.hydradb.com/connectors/{id}/resources' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
Path parameters
| Name | Description |
|---|---|
id | Connector UUID returned by POST /connectors. |
{
"resources": [
{
"connector_id": "{connector_id}",
"resource_id": "{resource_id}",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
status and provider_cursor to track sync state. A non-empty provider_cursor confirms the first sync has run.
Related Resources
- Add Connector Resource - add a single resource
- Delete Connector Resource - remove a resource
- Configure Connector - activate multiple resources with metadata and lookback settings
- Sync Connector - trigger a sync
Authorizations
API key sent as a Bearer token: "Bearer prefix.secret"
Path Parameters
Connector ID
Example:
"HydraDoc1234"
Response
OK
Show child attributes
Show child attributes
Example:
[
{
"additional_metadata": { "author": "ada", "doc_version": 3 },
"backfill_chunk_interval_seconds": 86400,
"backfill_oldest": "2026-06-01T00:00:00Z",
"connector_id": "conn_abc123",
"display_name": "general",
"filters": { "channel": "general" },
"metadata": { "department": "finance", "priority": 7 },
"provider_cursor": "1699999999.000100",
"provider_metadata": { "workspace_id": "T12345ACME" },
"resource_id": "C0123456789",
"resource_type": "channel",
"status": "completed",
"sync_blocked": true
}
]
Was this page helpful?