List visible data sources
Lists the repositories and workspaces visible to the calling API key, including readiness state. Call this first: every other tool accepts the returned name values in its data_sources/data_source argument (use id only for automation or to disambiguate duplicate names). Pass an optional query to rank sources by relevance to a question; the call is billed only when relevance ranking actually runs.
Authorizations
API Key authentication using Bearer token. Example: "Authorization: Bearer {apiKey}"
Body
Optional success projection. Omit to return both obj and rendered; use json for obj only; use agentic for rendered text only. Repairable errors always return both obj.error and rendered.
json, agentic Optional relevance query used to rank visible data sources.
When true, return only data sources ready for use. Default is true.
Response
Success envelope. obj contains data_sources (visible sources with id, name, fullName, readiness), relevance_status (not_requested | skipped | failed_open | succeeded), total_available, billed, and a usage hint; rendered is a compact <data_sources> XML block for agents. Repairable failures (missing or invalid arguments, ambiguous or unknown data sources) also return HTTP 200 with obj.error = { code, message, retry, try } and a rendered <tool_error> block; repair the arguments and retry.