List Connector Resources

List a connector’s configured resources and their settings.

GET /connectors/{id}/resources

cURL

curl 'https://api.hydradb.com/connectors/{id}/resources' \
  -H "Authorization: Bearer $HYDRA_DB_API_KEY" \
  -H "API-Version: 2"

200

{
  "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

curl 'https://api.hydradb.com/connectors/{id}/resources' \
  -H "Authorization: Bearer $HYDRA_DB_API_KEY" \
  -H "API-Version: 2"

200

{
  "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

Authorization · string · header · required

API key sent as a Bearer token: "Bearer prefix.secret"

Path Parameters

id · string · required

Connector ID

Example:

"HydraDoc1234"

Response

200

application/json

OK

resources · object[]

Resources configured on the connector, with their current sync state.

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
  }
]