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": "C0123456789",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"database_override": "",
"collection_override": "all-hands",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"custom_instructions": "Prioritize decisions and owners.",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
List Connector Resources
List a connector’s configured resources and their settings.
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": "C0123456789",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"database_override": "",
"collection_override": "all-hands",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"custom_instructions": "Prioritize decisions and owners.",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
Returns every resource configured on a connector, with its settings: display name, the collection it routes to, metadata,
custom_instructions when the resource has its own, and acl when it has an access rule.
provider_cursor is the resource’s saved sync position. It is empty until the resource’s first sync completes. For whether each resource is actually working, use Get Connector Status.
The resource_id values returned here are the ones to use in PATCH and DELETE /connectors/{id}/resources/{resource_id}.
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": "C0123456789",
"resource_type": "channel",
"display_name": "general",
"status": "active",
"provider_cursor": "{cursor}",
"database_override": "",
"collection_override": "all-hands",
"tenant_id_override": "",
"sub_tenant_id_override": "all-hands",
"custom_instructions": "Prioritize decisions and owners.",
"provider_metadata": null,
"filters": {
"lookback_days": 30
}
}
]
}
database_override and collection_override are empty when the resource uses the connector’s database and collection. tenant_id_override and sub_tenant_id_override repeat them under their deprecated names.
Related Resources
- Update Connector Resource: change one resource’s instructions or access rule
- Get Connector Status: per-resource health
- Configure Connector: add resources or change their routing and metadata
- Delete Connector Resource: stop syncing a resource
Authorizations
API key sent as a Bearer token: "Bearer prefix.secret"
Path Parameters
Connector ID
Example:
"HydraDoc1234"
Response
OK
Resources configured on the connector, with their current sync state.
Show child attributes
Show child attributes
Example:
[
{
"additional_metadata": { "author": "ada", "doc_version": 3 },
"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?