curl 'https://api.hydradb.com/connectors/{id}/discover' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"provider": "slack",
"resources": [
{
"id": "C0123456789",
"name": "general",
"resource_type": "channel"
},
{
"id": "C0987654321",
"name": "engineering",
"resource_type": "channel"
}
]
}
Discover Resources
List the resources a connector’s credentials can reach, before choosing which to sync.
curl 'https://api.hydradb.com/connectors/{id}/discover' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"provider": "slack",
"resources": [
{
"id": "C0123456789",
"name": "general",
"resource_type": "channel"
},
{
"id": "C0987654321",
"name": "engineering",
"resource_type": "channel"
}
]
}
id as resource_id, together with its resource_type and name, to Configure.
Providers that sync a whole account rather than individual resources return a single entry with id all and resource_type workspace. Configure that one entry to sync everything.
For providers with many resources, page through the list with limit (1 to 100) and cursor, and keep going while has_more is true.
curl 'https://api.hydradb.com/connectors/{id}/discover' \
-H "Authorization: Bearer $HYDRA_DB_API_KEY" \
-H "API-Version: 2"
{
"provider": "slack",
"resources": [
{
"id": "C0123456789",
"name": "general",
"resource_type": "channel"
},
{
"id": "C0987654321",
"name": "engineering",
"resource_type": "channel"
}
]
}
Errors
404: no connector with this id in your workspace.422: the stored credentials are no longer valid. Replace them with Update Connector.400or502: the provider rejected the request or could not be reached. The message carries the provider’s explanation.
Related Resources
- Next: Configure Connector: choose resources and start syncing
- List Connector Resources: resources already configured
Authorizations
API key sent as a Bearer token: "Bearer prefix.secret"
Path Parameters
Connector ID
"HydraDoc1234"
Query Parameters
Opaque pagination cursor from a previous response's next_cursor
Max resources per page, 1-100 (values above 100 are clamped)
Response
OK
Present and true when more pages remain. Only on paginated requests (limit or cursor); fetch the next page with next_cursor.
true
Opaque pagination cursor for the next page; null or absent when no more pages.
"eyJvZmZzZXQiOjUwfQ=="
External provider being synced (e.g. slack, github, linear, notion, gmail).
"slack"
Resources available to the connector's credentials. Pass an entry's id (as resource_id) and resource_type to Configure.
Show child attributes
Show child attributes
[
{
"id": "HydraDoc1234",
"metadata": { "department": "finance", "priority": 7 },
"name": "general",
"resource_type": "channel"
}
]
Was this page helpful?