Discover Resources

List all resources available from the provider before activating them.

GET /connectors/{id}/discover

cURL

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

200

{
  "provider": "slack",
  "connector_id": "{connector_id}",
  "resources": [
    {
      "id": "{resource_id}",
      "name": "general",
      "resource_type": "channel"
    },
    {
      "id": "{resource_id_2}",
      "name": "engineering",
      "resource_type": "channel"
    }
  ]
}

Queries the provider (Slack, GitHub, Linear, Notion, or Gmail) and returns every resource available to the connector’s credentials: channels, repos, teams, projects, databases, pages, or labels. Call this before Configure to decide which resources to activate.

cURL

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

Path parameters

Name	Description
id	Connector UUID returned by POST /connectors.

200

{
  "provider": "slack",
  "connector_id": "{connector_id}",
  "resources": [
    {
      "id": "{resource_id}",
      "name": "general",
      "resource_type": "channel"
    },
    {
      "id": "{resource_id_2}",
      "name": "engineering",
      "resource_type": "channel"
    }
  ]
}

Each item in resources represents one syncable unit. Pass the id and resource_type values to Configure to activate the ones you want.

Related Resources

• Next: Configure Connector - activate discovered resources
• Connector Resources - see already-activated resources and their sync state

Authorizations

Authorization · string · header · required

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

Path Parameters

id · string · required

Connector ID

Example:

"HydraDoc1234"

Query Parameters

cursor · string

Opaque pagination cursor from a previous response's next_cursor

limit · integer

Max resources per page, 1-100 (values above 100 are clamped)

Response

200

application/json

OK

has_more · boolean

Example:

true

next_cursor · string

Opaque pagination cursor for the next page; null or absent when no more pages.

Example:

"eyJvZmZzZXQiOjUwfQ=="

provider · string

External provider being synced (e.g. slack, github, linear, notion, gmail).

Example:

"slack"

resources · object[]

Show child attributes

Example:

[
  {
    "id": "HydraDoc1234",
    "metadata": { "department": "finance", "priority": 7 },
    "name": "general",
    "resource_type": "channel"
  }
]