---
title: "Discover Sources"
method: GET
path: "/api/data/sources/discover"
tags: ["datahub"]
---

# Discover Sources

`GET /api/data/sources/discover`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/data/sources/discover`
- Auth: HTTP bearer

Discover configured data sources matching a natural language query.

Provider capabilities are useful only after the corresponding
`data_sources` row exists. Returning bare `source_type` values caused
agents to attempt job creation without a UUID and then improvise around
400s. Include `source_id` when configured, and suppress unconfigured
capabilities so "no sources" is unambiguous.

## Query parameters

- `q` string, required: Natural language query to discover sources

## Response `200`

Successful Response

- DataSourceDiscoverResponse[]
  - `source_id` string, uuid, nullable
  - `source_type` string, required
  - `name` string, required
  - `description` string, required
  - `credit_cost` integer, required
  - `provider` string, required
  - `supported_params` string[]
  - `configured` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)