> ## Documentation Index
> Fetch the complete documentation index at: https://cortex-e852fafe-auto-update-openapi-6a9e3873a7492d091ac8c1f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Discover Resources
> List all resources available from the provider before activating them.
export const Field = ({name, type, required, recommended}) => {
const label = required ? 'required' : recommended ? 'recommended' : null;
const typeLabel = typeof type === 'string' ? type : null;
const ariaParts = [name, typeLabel && `${typeLabel}`, label].filter(Boolean);
return
{name}
{required && *}
{recommended && ●}
{type && {type}}
{label &&
{label}
}
;
};
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](/api-reference/v2/endpoint/configure-connector) to decide which resources to activate.
```bash cURL theme={null}
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`. |
```json 200 theme={null}
{
"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](/api-reference/v2/endpoint/configure-connector) to activate the ones you want.
## Related Resources
* **Next:** [Configure Connector](/api-reference/v2/endpoint/configure-connector) - activate discovered resources
* [Connector Resources](/api-reference/v2/endpoint/connector-resources) - see already-activated resources and their sync state
## OpenAPI
````yaml api-reference/v2/openapi.json GET /connectors/{id}/discover
openapi: 3.1.0
info:
contact:
email: support@hydradb.com
name: HydraDB Support
description: >-
HydraDB Application API — knowledge ingestion, search, and memory
management.
license:
name: Proprietary
title: HydraDB Application API
version: 0.1.0
servers:
- description: Production server
url: https://api.hydradb.com
security: []
externalDocs:
description: ''
url: ''
paths:
/connectors/{id}/discover:
get:
tags:
- connectors
summary: Discover connector resources
description: >-
List a connected provider's resources using the connector's stored
credentials. Passing cursor or limit opts into pagination (currently
Notion only): the response then adds next_cursor and has_more, a page
may hold fewer than limit resources, and clients must continue while
has_more is true. Without either param the full resource list is
returned.
parameters:
- description: Connector ID
in: path
name: id
required: true
schema:
example: HydraDoc1234
type: string
- description: Opaque pagination cursor from a previous response's next_cursor
in: query
name: cursor
schema:
type: string
- description: Max resources per page, 1-100 (values above 100 are clamped)
in: query
name: limit
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.discoverResponseBody'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.ErrorResponse'
description: Bad Request
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.ErrorResponse'
description: Not Found
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.ErrorResponse'
description: Internal Server Error
'502':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.ErrorResponse'
description: Bad Gateway
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/handler.ErrorResponse'
description: Service Unavailable
security:
- BearerAuth: []
components:
schemas:
handler.discoverResponseBody:
properties:
has_more:
example: true
type: boolean
next_cursor:
description: >-
Opaque pagination cursor for the next page; null or absent when no
more pages.
example: eyJvZmZzZXQiOjUwfQ==
type: string
provider:
description: >-
External provider being synced (e.g. `slack`, `github`, `linear`,
`notion`, `gmail`).
example: slack
type: string
resources:
example:
- id: HydraDoc1234
metadata:
department: finance
priority: 7
name: general
resource_type: channel
items:
$ref: '#/components/schemas/handler.discoveredResourceDTO'
type: array
uniqueItems: false
type: object
handler.ErrorResponse:
properties:
data: {}
detail:
$ref: '#/components/schemas/handler.ErrorDetail'
description: Structured error detail with code, message, and deprecation hints.
example:
deprecated: true
deprecated_field: tenant_id
error_code: VALIDATION_ERROR
message: Request validation failed
preferred_field: database
error:
$ref: '#/components/schemas/handler.apiError'
description: Error message, empty string on success.
example:
code: DATABASE_NOT_FOUND
message: Database not found
meta:
$ref: '#/components/schemas/handler.ErrorMeta'
example:
latency_ms: 12.3
request_id: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
success:
description: Whether the request succeeded.
example: true
type: boolean
type: object
handler.discoveredResourceDTO:
properties:
id:
description: Unique identifier for this resource.
example: HydraDoc1234
type: string
metadata:
additionalProperties: {}
example:
department: finance
priority: 7
type: object
name:
description: Human-readable label for this resource.
example: general
type: string
resource_type:
description: >-
Type of resource within the provider (e.g. `channel`, `repo`,
`linear_team`).
example: channel
type: string
type: object
handler.ErrorDetail:
properties:
deprecated:
description: Whether this response concerns a deprecated field or route.
example: true
type: boolean
deprecated_field:
description: The deprecated field name.
example: tenant_id
type: string
error_code:
description: Machine-readable error classification code.
example: VALIDATION_ERROR
type: string
message:
description: Human-readable description of the error.
example: Request validation failed
type: string
preferred_field:
description: The canonical replacement for the deprecated field.
example: database
type: string
success:
deprecated: true
description: >-
Deprecated for API clients: always false on this path, so it carries
no
information. To detect a failure read the HTTP status code; for what
went wrong read the envelope's error.code and error.message, and
meta.request_id when reporting it. The whole `detail` object is
deprecated legacy — tagging the field individually so SDK users see
it
on the property, not just the container (PRO-1208).
example: true
type: boolean
x-deprecated: 'true'
type: object
handler.apiError:
properties:
code:
description: Machine-readable error code (e.g. `DATABASE_NOT_FOUND`).
example: DATABASE_NOT_FOUND
type: string
message:
description: Human-readable description of the error.
example: Database not found
type: string
type: object
handler.ErrorMeta:
properties:
api_version:
type: string
latency_ms:
example: 12.3
type: number
request_id:
description: Unique identifier for this request, useful for support and tracing.
example: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
type: string
type: object
securitySchemes:
BearerAuth:
bearerFormat: API key
description: 'API key sent as a Bearer token: "Bearer prefix.secret"'
scheme: bearer
type: http
````