Describe a datasource
The exposed tables and columns on one datasource, with types, keys, row estimates, profiled statistics, and any published documentation. Call this before writing a query — it carries the context column names don’t.
full=1 instead returns the complete introspected schema, including tables nobody has exposed — the list an admin picks exposure from. It requires your account to manage this datasource (an admin/owner team role), independent of your key’s scopes, and 409s with NOT_CONNECTED if the datasource has never been introspected.
Authorizations
An API key (sk_live_...) created under Settings → API keys, or a short-lived JWT access token from a browser session. A key only reaches the scope it was granted; see API keys and scopes.
Path Parameters
Datasource id from GET /teams/{teamId}/datasources.
Query Parameters
Pass 1 for the full introspected schema instead of the exposed subset. Requires a manage-level team role.
1 Response
The exposed subset (default), or the full introspected schema when full=1.
POSTGRES, MONGODB, BIGQUERY What this source calls its own concepts — write a query using these words, not "schema"/"table" by default.