Discover Resources

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

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

GET

connectors

{id}

discover

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

{
  "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 '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`.

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

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

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

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

API Documentation

Databases

Context

Query

Connectors

Webhooks

Miscellaneous

Path parameters

Authorizations

Path Parameters

Query Parameters

Response

​Path parameters

​Related Resources

Authorizations

Path Parameters

Query Parameters

Response

Path parameters

Related Resources