Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind 1,2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).
An MCP token or a Parable token can call this operation. See Authentication for the kinds of token.Your roles must grant tenant.data.query.providers.
Errors
HTTP 400: Parable refused the SQL. The message gives the reason, and the code is a QL code, such as QL-PL-002 for a table or function the Provider Pools do not serve. Correct the SQL from the stated reason; describe the table again if a name is unknown. Do not resend the same statement.
HTTP 403: The caller may not query data in this Workspace. Ask a Workspace Administrator for the Provider Pools Reader role. A different query does not help.
HTTP 504: The statement ran past its time budget (a QL-TO code) or did not finish in 30 seconds. Filter on a partition column, aggregate, or add a LIMIT.
HTTP 429: Too many queries were running, so the statement did not start (QL-IN-008), or the caller sent more than 120 of these requests in a minute. Nothing ran. Wait a moment, or for the seconds in the Retry-After header when it is set, then send the same request again.
HTTP 503: The statement stopped for lack of memory (QL-IN-009), a service it needs did not answer, such as the model service behind semantic ranking or a SQL AI function (QL-IN-010), or a worker that ran part of it stopped (QL-IN-012). The code says which. Try again shortly. For QL-IN-009, read fewer columns or rows, or aggregate.
Authorizations
Authorization
string
header
required
A personal access token, which starts with pat_. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.
Headers
X-Tenant
string
Workspace slug. Overrides subdomain-based workspace resolution when provided.
Example:
"acme"
X-Request-ID
string<uuid>
Optional request correlation ID echoed back in the response.
Example:
"550e8400-e29b-41d4-a716-446655440000"
Body
application/json
One SQL statement to run against the Provider Pools, or to plan without
running.
sql
string
required
Single read-only SQL statement. Text.Sql rejects empty; maxLength is 100000 bytes.
Required string length: 1 - 100000
Pattern: ^[\s\S]*$
parameters
any[] | null
Positional values for $1, $2, ... placeholders, sent through Flight SQL
prepared-statement binding. Values are never interpolated into SQL.
Each value is a JSON scalar (string, finite number, boolean, or null).
Identifiers and the arguments of search_available_data cannot be bound.
Any valid JSON value: object, array, primitive, or null
Response
Successful response
data
object
required
A SQL result a model can read: typed columns and whole leading rows as
JSON.
Each row is a JSON array with one value per column, in column order. A
value is written by its column's arrowType:
A 64-bit integer inside the JavaScript safe range, a smaller integer and
a finite float are JSON numbers. A 64-bit integer past 2^53 - 1 is text.
A decimal is text with every digit of its scale, such as 1.50.
A date is YYYY-MM-DD. A timestamp is ISO 8601 with the fraction its
unit holds; one with a time zone is the UTC instant and ends with Z,
one without is a wall-clock time and carries no zone.
A time is HH:MM:SS with its fraction, a duration ISO 8601 seconds.
Binary is base64. A struct is an object, a list an array, a map an
object.
A null is JSON null.
Nothing is rounded.
Show child attributes
meta
object
required
Show child attributes
links
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Parable Developers","description":"API, SDKs, and guides for your Parable workspace.","colors":{"primary":"#FD4A82","light":"#FD4A82","dark":"#5B2358"},"logo":{"light":"https://mintcdn.com/parable-developers/UTSJfzIbTEfjJnnx/images/logo-light.svg?fit=max\u0026auto=format\u0026n=UTSJfzIbTEfjJnnx\u0026q=85\u0026s=fe5b632595d97d15e9a8629ee338c49c","dark":"https://mintcdn.com/parable-developers/UTSJfzIbTEfjJnnx/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=UTSJfzIbTEfjJnnx\u0026q=85\u0026s=2ceae01a56fe8621dffcb5262c1bd3b3"},"favicon":"https://mintcdn.com/parable-developers/UTSJfzIbTEfjJnnx/favicon.svg?fit=max\u0026auto=format\u0026n=UTSJfzIbTEfjJnnx\u0026q=85\u0026s=8e74de013d02c6e629d6eca524ff63de","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript","go"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://docs.parable.work","label":"Product Docs"}],"primary":{"type":"button","label":"Sign In","href":"https://app.parable.work"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/parablework","twitter":"https://twitter.com/parableai"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"parable-developers","hasAudioNarration":false,"actualSubdomain":"parable-developers","customDomains":["developers.askparable.com"],"gitSource":{"type":"github","owner":"parable-work","repo":"parable-platform","deployBranch":"docs/main","contentDirectory":"docs/developer","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af77ffa1da61c62b8c41179","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":133},{"language":"default","tag":"REST API","count":131},{"language":"default","tag":"Documentation","count":29},{"language":"default","tag":"Artifacts","count":19},{"language":"default","tag":"Vendors","count":15},{"language":"default","tag":"Provider policies","count":12},{"language":"default","tag":"Users","count":11},{"language":"default","tag":"Parable Data Engine","count":10},{"language":"default","tag":"Providers","count":8},{"language":"default","tag":"Connectors","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/provider-pool/query-the-provider-pool","slug":"/api-reference/provider-pool/query-the-provider-pool","pageMetadata":{"title":"Query the Provider Pool","description":"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).","deprecated":null,"version":null,"audience":"workspace","capability":"providers.pool.query","hidden":false,"lifecycle":"experimental","mappingStatus":"mapped","public":true,"openapi":"/api-reference/openapi.json post /api/provider-pool/query","href":"/api-reference/provider-pool/query-the-provider-pool","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n annotation: \"annotation\",\n math: \"math\",\n mn: \"mn\",\n mo: \"mo\",\n mrow: \"mrow\",\n p: \"p\",\n semantics: \"semantics\",\n span: \"span\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind \", _jsxs(_components.span, {\n className: \"katex\",\n children: [_jsx(_components.span, {\n className: \"katex-mathml\",\n children: _jsx(_components.math, {\n xmlns: \"http://www.w3.org/1998/Math/MathML\",\n children: _jsxs(_components.semantics, {\n children: [_jsxs(_components.mrow, {\n children: [_jsx(_components.mn, {\n children: \"1\"\n }), _jsx(_components.mo, {\n separator: \"true\",\n children: \",\"\n })]\n }), _jsx(_components.annotation, {\n encoding: \"application/x-tex\",\n children: \"1, \"\n })]\n })\n })\n }), _jsx(_components.span, {\n className: \"katex-html\",\n \"aria-hidden\": \"true\",\n children: _jsxs(_components.span, {\n className: \"base\",\n children: [_jsx(_components.span, {\n className: \"strut\",\n style: {\n height: \"0.8389em\",\n verticalAlign: \"-0.1944em\"\n }\n }), _jsx(_components.span, {\n className: \"mord\",\n children: \"1\"\n }), _jsx(_components.span, {\n className: \"mpunct\",\n children: \",\"\n })]\n })\n })]\n }), \"2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`access`,children:`Access`}),`\n`,_jsxs(_components.p,{children:[`An MCP token or a Parable token can call this operation. See `,_jsx(_components.a,{href:`/getting-started/authentication`,children:`Authentication`}),` for the kinds of token.`]}),`\n`,_jsxs(_components.p,{children:[`Your roles must grant `,_jsx(_components.code,{children:`tenant.data.query.providers`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`HTTP 400`}),`: Parable refused the SQL. The message gives the reason, and the code is a QL code, such as QL-PL-002 for a table or function the Provider Pools do not serve. Correct the SQL from the stated reason; describe the table again if a name is unknown. Do not resend the same statement.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`HTTP 403`}),`: The caller may not query data in this Workspace. Ask a Workspace Administrator for the Provider Pools Reader role. A different query does not help.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`HTTP 504`}),`: The statement ran past its time budget (a QL-TO code) or did not finish in 30 seconds. Filter on a partition column, aggregate, or add a LIMIT.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`HTTP 429`}),`: Too many queries were running, so the statement did not start (QL-IN-008), or the caller sent more than 120 of these requests in a minute. Nothing ran. Wait a moment, or for the seconds in the Retry-After header when it is set, then send the same request again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`HTTP 503`}),`: The statement stopped for lack of memory (QL-IN-009), a service it needs did not answer, such as the model service behind semantic ranking or a SQL AI function (QL-IN-010), or a worker that ran part of it stopped (QL-IN-012). The code says which. Try again shortly. For QL-IN-009, read fewer columns or rows, or aggregate.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Query the Provider Pool","description":"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).","deprecated":null,"version":null,"audience":"workspace","capability":"providers.pool.query","hidden":false,"lifecycle":"experimental","mappingStatus":"mapped","public":true,"openapi":"/api-reference/openapi.json post /api/provider-pool/query","href":"/api-reference/provider-pool/query-the-provider-pool","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Access","slug":"access","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).","operationId":"ProviderPoolQueryProviderPoolHandler","parameters":["55a451d5-0b97-4ffb-a699-5995b8491abe","1611c62f-99e9-444e-be57-c5aca814c2a8"],"requestBody":"e424f5b2-2567-462c-a2da-d32a7daa53b7","responses":{"200":"cd19058e-c4ce-4057-aab3-5619a8702674","400":"a6e5d74f-1ce5-47aa-9e29-7b7e3a38df89","401":"f6039a6c-2f4f-4fe8-a896-4565f7b0077d","403":"dfa75a3c-bba0-4688-8393-ef3c8a1a60dc","413":"d2b3a599-1557-4e11-93a9-1b0b18cb78ed","429":"1957ba58-4e32-4059-82a5-0f4ceeb44cd8","500":"9e907ada-098b-44b7-8dc1-b38c3bf5ae30","504":"b213e057-ba9b-45f7-bc58-c98594c56ed7"},"security":["3b0f5756-0c50-4c45-bdde-80dda7f0e99c"],"summary":"Query the Provider Pool","tags":["Provider pool"],"x-codeSamples":[{"label":"TypeScript SDK","lang":"typescript","source":"import { WebApiSDK } from \"@parable-platform/web-api-sdk\";\nimport type { ProviderPoolQueryInput } from \"@parable-platform/web-api-types\";\n\nconst sdk = new WebApiSDK({\n baseUrl: process.env.PARABLE_API_URL!,\n auth: { token: process.env.PARABLE_API_TOKEN! },\n requestInterceptor: (config) => ({\n ...config,\n headers: { ...config.headers, \"X-Tenant\": process.env.PARABLE_WORKSPACE! },\n }),\n});\n\nconst input: ProviderPoolQueryInput = JSON.parse(`{\n \"sql\": \"example\"\n}`);\nconst result = await sdk.providerPool.queryProviderPool(\n input\n);"},{"label":"Python SDK","lang":"python","source":"import json\nimport os\n\nfrom parable_types_web_api import ProviderPoolQueryInput\nfrom parable_web_api_sdk import ClientConfig, WebApiSDK\n\nsdk = WebApiSDK(\n ClientConfig(\n base_url=os.environ[\"PARABLE_API_URL\"],\n auth_token=os.environ[\"PARABLE_API_TOKEN\"],\n default_headers={\"X-Tenant\": os.environ[\"PARABLE_WORKSPACE\"]},\n )\n)\n\ninput_data = ProviderPoolQueryInput.model_validate(\n json.loads(\"{\\\"sql\\\":\\\"example\\\"}\"),\n)\nresult = sdk.provider_pool.query_provider_pool(input_data)"},{"label":"Rust SDK","lang":"rust","source":"use parable_web_api_sdk::{types, ClientConfig, RequestOptions, WebApiSdk};\n\nlet sdk = WebApiSdk::new(ClientConfig::with_base_url(\n std::env::var(\"PARABLE_API_URL\")?,\n Some(std::env::var(\"PARABLE_API_TOKEN\")?),\n None,\n))?;\nlet options = RequestOptions::with_header(\"X-Tenant\", std::env::var(\"PARABLE_WORKSPACE\")?, None, None);\n\nlet input: types::ProviderPoolQueryInput = serde_json::from_value(\n serde_json::json!({\n \"sql\": \"example\"\n}),\n)?;\nlet result = sdk.provider_pool.query_provider_pool(\n input,\n Some(\u0026options)\n).await?;"},{"label":"Go SDK","lang":"go","source":"sdk, err := webapisdk.New(webapisdk.SDKConfig{\n\tBaseURL: os.Getenv(\"PARABLE_API_URL\"),\n\tAuth: \u0026webapisdk.AuthConfig{Token: os.Getenv(\"PARABLE_API_TOKEN\")},\n\tRequestInterceptor: func(ctx context.Context, req *http.Request) error {\n\t\treq.Header.Set(\"X-Tenant\", os.Getenv(\"PARABLE_WORKSPACE\"))\n\t\treturn nil\n\t},\n})\nif err != nil {\n\treturn err\n}\n\nvar input webapitypes.ProviderPoolQueryInput\nif err := json.Unmarshal([]byte(`{\"sql\":\"example\"}`), \u0026input); err != nil {\n\treturn err\n}\nresult, err := sdk.ProviderPoolNamespace.QueryProviderPool(ctx, input)"}],"x-hidden":false,"x-mint":{"metadata":{"audience":"workspace","capability":"providers.pool.query","hidden":false,"lifecycle":"experimental","mappingStatus":"mapped","public":true},"content":"## Access\n\nAn MCP token or a Parable token can call this operation. See [Authentication](/getting-started/authentication) for the kinds of token.\n\nYour roles must grant `tenant.data.query.providers`.\n\n## Errors\n\n- `HTTP 400`: Parable refused the SQL. The message gives the reason, and the code is a QL code, such as QL-PL-002 for a table or function the Provider Pools do not serve. Correct the SQL from the stated reason; describe the table again if a name is unknown. Do not resend the same statement.\n- `HTTP 403`: The caller may not query data in this Workspace. Ask a Workspace Administrator for the Provider Pools Reader role. A different query does not help.\n- `HTTP 504`: The statement ran past its time budget (a QL-TO code) or did not finish in 30 seconds. Filter on a partition column, aggregate, or add a LIMIT.\n- `HTTP 429`: Too many queries were running, so the statement did not start (QL-IN-008), or the caller sent more than 120 of these requests in a minute. Nothing ran. Wait a moment, or for the seconds in the Retry-After header when it is set, then send the same request again.\n- `HTTP 503`: The statement stopped for lack of memory (QL-IN-009), a service it needs did not answer, such as the model service behind semantic ranking or a SQL AI function (QL-IN-010), or a worker that ran part of it stopped (QL-IN-012). The code says which. Try again shortly. For QL-IN-009, read fewer columns or rows, or aggregate."},"x-parable-docs":{"audience":"workspace","capability":"providers.pool.query","description":"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).","doNotUseWhen":"Do not use this operation to preview a Plot inside a Parable, to read the Workspace, Artifact or Parable Pools, or to write data.","errors":[{"code":"HTTP 400","commonCorrection":"Correct the SQL from the stated reason; describe the table again if a name is unknown. Do not resend the same statement.","description":"Parable refused the SQL. The message gives the reason, and the code is a QL code, such as QL-PL-002 for a table or function the Provider Pools do not serve."},{"code":"HTTP 403","commonCorrection":"Ask a Workspace Administrator for the Provider Pools Reader role. A different query does not help.","description":"The caller may not query data in this Workspace."},{"code":"HTTP 504","commonCorrection":"Filter on a partition column, aggregate, or add a LIMIT.","description":"The statement ran past its time budget (a QL-TO code) or did not finish in 30 seconds."},{"code":"HTTP 429","commonCorrection":"Wait a moment, or for the seconds in the Retry-After header when it is set, then send the same request again.","description":"Too many queries were running, so the statement did not start (QL-IN-008), or the caller sent more than 120 of these requests in a minute. Nothing ran."},{"code":"HTTP 503","commonCorrection":"Try again shortly. For QL-IN-009, read fewer columns or rows, or aggregate.","description":"The statement stopped for lack of memory (QL-IN-009), a service it needs did not answer, such as the model service behind semantic ranking or a SQL AI function (QL-IN-010), or a worker that ran part of it stopped (QL-IN-012). The code says which."}],"lifecycle":"experimental","mappingStatus":"mapped","replay":{"expectedRevisionPointers":[],"idempotencyKeyPointers":[],"mode":"read_only"},"success":"Returns typed columns and whole leading rows, how many rows the view holds, what was left out and why, processing warnings for scanned tables, and the elapsed time.","title":"Query the Provider Pool","tokenScope":"data:read","useWhen":"Run one read-only SQL statement over Provider data and read its rows as typed JSON. Write a LIMIT, an aggregation or a filter to bound the rows, and bind values with $1, $2 and parameters.","visibility":"internal"},"x-parable-permissions":["tenant.data.query.providers","admin.tenant.view","admin.tenant.data.query"],"method":"post","type":"path","servers":[],"path":"/api/provider-pool/query","baseUrlOptions":[],"title":"Query the Provider Pool","codeSamples":[{"label":"TypeScript SDK","lang":"typescript","source":"import { WebApiSDK } from \"@parable-platform/web-api-sdk\";\nimport type { ProviderPoolQueryInput } from \"@parable-platform/web-api-types\";\n\nconst sdk = new WebApiSDK({\n baseUrl: process.env.PARABLE_API_URL!,\n auth: { token: process.env.PARABLE_API_TOKEN! },\n requestInterceptor: (config) => ({\n ...config,\n headers: { ...config.headers, \"X-Tenant\": process.env.PARABLE_WORKSPACE! },\n }),\n});\n\nconst input: ProviderPoolQueryInput = JSON.parse(`{\n \"sql\": \"example\"\n}`);\nconst result = await sdk.providerPool.queryProviderPool(\n input\n);"},{"label":"Python SDK","lang":"python","source":"import json\nimport os\n\nfrom parable_types_web_api import ProviderPoolQueryInput\nfrom parable_web_api_sdk import ClientConfig, WebApiSDK\n\nsdk = WebApiSDK(\n ClientConfig(\n base_url=os.environ[\"PARABLE_API_URL\"],\n auth_token=os.environ[\"PARABLE_API_TOKEN\"],\n default_headers={\"X-Tenant\": os.environ[\"PARABLE_WORKSPACE\"]},\n )\n)\n\ninput_data = ProviderPoolQueryInput.model_validate(\n json.loads(\"{\\\"sql\\\":\\\"example\\\"}\"),\n)\nresult = sdk.provider_pool.query_provider_pool(input_data)"},{"label":"Rust SDK","lang":"rust","source":"use parable_web_api_sdk::{types, ClientConfig, RequestOptions, WebApiSdk};\n\nlet sdk = WebApiSdk::new(ClientConfig::with_base_url(\n std::env::var(\"PARABLE_API_URL\")?,\n Some(std::env::var(\"PARABLE_API_TOKEN\")?),\n None,\n))?;\nlet options = RequestOptions::with_header(\"X-Tenant\", std::env::var(\"PARABLE_WORKSPACE\")?, None, None);\n\nlet input: types::ProviderPoolQueryInput = serde_json::from_value(\n serde_json::json!({\n \"sql\": \"example\"\n}),\n)?;\nlet result = sdk.provider_pool.query_provider_pool(\n input,\n Some(\u0026options)\n).await?;"},{"label":"Go SDK","lang":"go","source":"sdk, err := webapisdk.New(webapisdk.SDKConfig{\n\tBaseURL: os.Getenv(\"PARABLE_API_URL\"),\n\tAuth: \u0026webapisdk.AuthConfig{Token: os.Getenv(\"PARABLE_API_TOKEN\")},\n\tRequestInterceptor: func(ctx context.Context, req *http.Request) error {\n\t\treq.Header.Set(\"X-Tenant\", os.Getenv(\"PARABLE_WORKSPACE\"))\n\t\treturn nil\n\t},\n})\nif err != nil {\n\treturn err\n}\n\nvar input webapitypes.ProviderPoolQueryInput\nif err := json.Unmarshal([]byte(`{\"sql\":\"example\"}`), \u0026input); err != nil {\n\treturn err\n}\nresult, err := sdk.ProviderPoolNamespace.QueryProviderPool(ctx, input)"}],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"55a451d5-0b97-4ffb-a699-5995b8491abe":{"description":"Workspace slug. Overrides subdomain-based workspace resolution when provided.","in":"header","name":"X-Tenant","required":false,"schema":{"example":"acme","type":"string","isRequired":false,"description":"Workspace slug. Overrides subdomain-based workspace resolution when provided.","uniqueKey":"","typeLabel":"string"}},"1611c62f-99e9-444e-be57-c5aca814c2a8":{"description":"Optional request correlation ID echoed back in the response.","in":"header","name":"X-Request-ID","required":false,"schema":{"example":"550e8400-e29b-41d4-a716-446655440000","format":"uuid","type":"string","isRequired":false,"description":"Optional request correlation ID echoed back in the response.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"description":"One SQL statement to run against the Provider Pools, or to plan without\nrunning.","properties":{"sql":{"description":"Single read-only SQL statement. Text.Sql rejects empty; maxLength is 100000 bytes.","maxLength":100000,"minLength":1,"pattern":"^[\\s\\S]*$","type":"string","isRequired":true,"uniqueKey":"sql","typeLabel":"string"},"parameters":{"oneOf":[{"description":"Positional values for $1, $2, ... placeholders, sent through Flight SQL\nprepared-statement binding. Values are never interpolated into SQL.\nEach value is a JSON scalar (string, finite number, boolean, or null).\nIdentifiers and the arguments of search_available_data cannot be bound.","items":{"description":"Any valid JSON value: object, array, primitive, or null","uniqueKey":"parameters.oneOf.0.items.[INDEX]","typeLabel":"any"},"type":"array","uniqueKey":"parameters.oneOf.0","typeLabel":"any[]"},{"description":"Positional values for $1, $2, ... placeholders, sent through Flight SQL\nprepared-statement binding. Values are never interpolated into SQL.\nEach value is a JSON scalar (string, finite number, boolean, or null).\nIdentifiers and the arguments of search_available_data cannot be bound.","items":{"description":"Any valid JSON value: object, array, primitive, or null"},"type":"null","uniqueKey":"parameters.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameters","typeLabel":"any[] | null"}},"required":["sql"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sql":"\u003cstring>","parameters":["\u003cunknown>"]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"cd19058e-c4ce-4057-aab3-5619a8702674":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"A SQL result a model can read: typed columns and whole leading rows as\nJSON.\nEach row is a JSON array with one value per column, in column order. A\nvalue is written by its column's arrowType:\n1. A 64-bit integer inside the JavaScript safe range, a smaller integer and\na finite float are JSON numbers. A 64-bit integer past 2^53 - 1 is text.\n2. A decimal is text with every digit of its scale, such as `1.50`.\n3. A date is `YYYY-MM-DD`. A timestamp is ISO 8601 with the fraction its\nunit holds; one with a time zone is the UTC instant and ends with `Z`,\none without is a wall-clock time and carries no zone.\n4. A time is `HH:MM:SS` with its fraction, a duration ISO 8601 seconds.\n5. Binary is base64. A struct is an object, a list an array, a map an\nobject.\n6. A null is JSON null.\nNothing is rounded.","properties":{"columns":{"items":{"description":"One column of a result or of a planned statement.","properties":{"arrowType":{"description":"The column's Arrow type, such as `int64`, `utf8`, `decimal(38, 9)` or\n`timestamp[us, tz=UTC]`. It says how to read a value that arrives as text.","type":"string","isRequired":true,"uniqueKey":"data.columns.items.[INDEX].arrowType","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.columns.items.[INDEX].name","typeLabel":"string"},"scalarRef":{"oneOf":[{"description":"The Parable scalar the column carries, such as `Contact.Email`; null when\nit carries none.","maxLength":128,"minLength":3,"pattern":"^[A-Z][A-Za-z0-9]*\\.[A-Z][A-Za-z0-9]*$","type":"string","uniqueKey":"data.columns.items.[INDEX].scalarRef.oneOf.0","typeLabel":"string"},{"description":"The Parable scalar the column carries, such as `Contact.Email`; null when\nit carries none.","maxLength":128,"minLength":3,"pattern":"^[A-Z][A-Za-z0-9]*\\.[A-Z][A-Za-z0-9]*$","type":"null","uniqueKey":"data.columns.items.[INDEX].scalarRef.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.columns.items.[INDEX].scalarRef","typeLabel":"string | null"}},"required":["name","arrowType"],"type":"object","uniqueKey":"data.columns.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data.columns","typeLabel":"object[]"},"elapsedMs":{"description":"Signed integer count of milliseconds: an amount of elapsed time, never a point in time. An epoch timestamp is Temporal.DateTime with x-temporal-format: unix_millis.","format":"int64","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"data.elapsedMs","typeLabel":"integer\u003cint64>"},"requestId":{"description":"The request's id in the Workspace API's logs.","type":"string","isRequired":true,"uniqueKey":"data.requestId","typeLabel":"string"},"returnedRows":{"description":"The rows in this view. It is never the statement's total.","format":"int64","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"data.returnedRows","typeLabel":"integer\u003cint64>"},"rows":{"items":{"description":"Any valid JSON value: object, array, primitive, or null","uniqueKey":"data.rows.items.[INDEX]","typeLabel":"any"},"type":"array","isRequired":true,"uniqueKey":"data.rows","typeLabel":"any[]"},"truncated":{"description":"What a result view left out. A view with any flag set is not the whole\nresult.","properties":{"capture":{"description":"Reading stopped at 3 MiB of Arrow, so the statement may hold more rows\nthan were read.","type":"boolean","isRequired":true,"uniqueKey":"data.truncated.capture","typeLabel":"boolean"},"rows":{"description":"Rows after the last one shown were left out to keep the view inside its\n60,000-character budget.","type":"boolean","isRequired":true,"uniqueKey":"data.truncated.rows","typeLabel":"boolean"},"values":{"description":"At least one shown text or binary value was cut at 2,000 characters; a\ncut value ends with `[cut: ...]`.","type":"boolean","isRequired":true,"uniqueKey":"data.truncated.values","typeLabel":"boolean"}},"required":["rows","values","capture"],"type":"object","isRequired":true,"uniqueKey":"data.truncated","typeLabel":"object"},"warnings":{"description":"What to change to see what was left out, in plain sentences.","items":{"type":"string","uniqueKey":"data.warnings.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"data.warnings","typeLabel":"string[]"},"catalogVersion":{"oneOf":[{"description":"The catalog the statement was planned against. Null when Parable does\nnot report one with a result.","type":"string","uniqueKey":"data.catalogVersion.oneOf.0","typeLabel":"string"},{"description":"The catalog the statement was planned against. Null when Parable does\nnot report one with a result.","type":"null","uniqueKey":"data.catalogVersion.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.catalogVersion","typeLabel":"string | null"}},"required":["columns","rows","returnedRows","truncated","elapsedMs","requestId","warnings"],"type":"object","isRequired":true,"uniqueKey":"data","typeLabel":"object"},"meta":{"properties":{"requestId":{"description":"Unique identifier for the request","type":"string","isRequired":true,"uniqueKey":"meta.requestId","typeLabel":"string"},"totalCount":{"oneOf":[{"description":"Total count of items for paginated responses","type":"integer","uniqueKey":"meta.totalCount.oneOf.0","typeLabel":"integer"},{"description":"Total count of items for paginated responses","type":"null","uniqueKey":"meta.totalCount.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.totalCount","typeLabel":"integer | null"}},"required":["requestId"],"type":"object","isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"links":{"properties":{"first":{"oneOf":[{"type":"string","uniqueKey":"links.first.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"links.first.oneOf.1","typeLabel":"null"}],"uniqueKey":"links.first","typeLabel":"string | null"},"last":{"oneOf":[{"type":"string","uniqueKey":"links.last.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"links.last.oneOf.1","typeLabel":"null"}],"uniqueKey":"links.last","typeLabel":"string | null"},"next":{"oneOf":[{"type":"string","uniqueKey":"links.next.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"links.next.oneOf.1","typeLabel":"null"}],"uniqueKey":"links.next","typeLabel":"string | null"},"prev":{"oneOf":[{"type":"string","uniqueKey":"links.prev.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"links.prev.oneOf.1","typeLabel":"null"}],"uniqueKey":"links.prev","typeLabel":"string | null"}},"type":"object","uniqueKey":"links","typeLabel":"object"}},"required":["data","meta"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"columns":[{"arrowType":"\u003cstring>","name":"\u003cstring>","scalarRef":"\u003cstring>"}],"elapsedMs":0,"requestId":"\u003cstring>","returnedRows":0,"rows":["\u003cunknown>"],"truncated":{"capture":true,"rows":true,"values":true},"warnings":["\u003cstring>"],"catalogVersion":"\u003cstring>"},"meta":{"requestId":"\u003cstring>","totalCount":123},"links":{"first":"\u003cstring>","last":"\u003cstring>","next":"\u003cstring>","prev":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Successful response","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"a6e5d74f-1ce5-47aa-9e29-7b7e3a38df89":{"content":{"application/problem+json":{"schema":{"description":"An error response in the Problem Details format (RFC 9457).","properties":{"detail":{"description":"What went wrong with this request.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"description":"The HTTP status code.","example":400,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"title":{"description":"A short summary, usually the text of the HTTP status.","example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The problem type. It is `about:blank`: the status and `code` identify the problem.","example":"about:blank","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"description":"The stable error code, when the problem has one.","example":"WA-VL-001","type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"description":"Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it.","uniqueKey":"details","typeLabel":"any"},"errors":{"description":"The fields or filters that failed validation. Only a validation or filter error has it.","uniqueKey":"errors","typeLabel":"any"},"requestId":{"description":"The ID of the request, when the problem has one. The `X-Request-ID` response header always has it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["type","title","status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","status":400,"title":"Bad Request","type":"about:blank","code":"WA-VL-001","details":"\u003cunknown>","errors":"\u003cunknown>","requestId":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The request is not valid. `detail` says why. A value that breaks a field rule gives the code `WA-VL-001` and an `errors` member that names each field.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"f6039a6c-2f4f-4fe8-a896-4565f7b0077d":{"content":{"application/problem+json":{"schema":{"description":"An error response in the Problem Details format (RFC 9457).","properties":{"detail":{"description":"What went wrong with this request.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"description":"The HTTP status code.","example":400,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"title":{"description":"A short summary, usually the text of the HTTP status.","example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The problem type. It is `about:blank`: the status and `code` identify the problem.","example":"about:blank","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"description":"The stable error code, when the problem has one.","example":"WA-VL-001","type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"description":"Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it.","uniqueKey":"details","typeLabel":"any"},"errors":{"description":"The fields or filters that failed validation. Only a validation or filter error has it.","uniqueKey":"errors","typeLabel":"any"},"requestId":{"description":"The ID of the request, when the problem has one. The `X-Request-ID` response header always has it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["type","title","status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","status":400,"title":"Bad Request","type":"about:blank","code":"WA-VL-001","details":"\u003cunknown>","errors":"\u003cunknown>","requestId":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The token is missing, malformed, revoked, or expired.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"dfa75a3c-bba0-4688-8393-ef3c8a1a60dc":{"content":{"application/problem+json":{"schema":{"description":"An error response in the Problem Details format (RFC 9457).","properties":{"detail":{"description":"What went wrong with this request.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"description":"The HTTP status code.","example":400,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"title":{"description":"A short summary, usually the text of the HTTP status.","example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The problem type. It is `about:blank`: the status and `code` identify the problem.","example":"about:blank","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"description":"The stable error code, when the problem has one.","example":"WA-VL-001","type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"description":"Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it.","uniqueKey":"details","typeLabel":"any"},"errors":{"description":"The fields or filters that failed validation. Only a validation or filter error has it.","uniqueKey":"errors","typeLabel":"any"},"requestId":{"description":"The ID of the request, when the problem has one. The `X-Request-ID` response header always has it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["type","title","status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","status":400,"title":"Bad Request","type":"about:blank","code":"WA-VL-001","details":"\u003cunknown>","errors":"\u003cunknown>","requestId":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The token cannot make this request. For example, the roles of its owner do not allow the operation.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"d2b3a599-1557-4e11-93a9-1b0b18cb78ed":{"content":{"application/problem+json":{"schema":{"description":"An error response in the Problem Details format (RFC 9457).","properties":{"detail":{"description":"What went wrong with this request.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"description":"The HTTP status code.","example":400,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"title":{"description":"A short summary, usually the text of the HTTP status.","example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The problem type. It is `about:blank`: the status and `code` identify the problem.","example":"about:blank","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"description":"The stable error code, when the problem has one.","example":"WA-VL-001","type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"description":"Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it.","uniqueKey":"details","typeLabel":"any"},"errors":{"description":"The fields or filters that failed validation. Only a validation or filter error has it.","uniqueKey":"errors","typeLabel":"any"},"requestId":{"description":"The ID of the request, when the problem has one. The `X-Request-ID` response header always has it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["type","title","status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","status":400,"title":"Bad Request","type":"about:blank","code":"WA-VL-001","details":"\u003cunknown>","errors":"\u003cunknown>","requestId":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The request body is larger than 1 MB.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"1957ba58-4e32-4059-82a5-0f4ceeb44cd8":{"content":{"text/plain":{"schema":{"example":"Too Many Requests","type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"Too Many Requests"}},"exampleType":"generated"}},"description":"More than 120 requests a minute came from your address. Wait for the number of seconds in `Retry-After`, then try again.","headers":{"Retry-After":{"description":"The number of seconds to wait before you try again.","schema":{"type":"integer"}},"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"9e907ada-098b-44b7-8dc1-b38c3bf5ae30":{"content":{"application/problem+json":{"schema":{"description":"An error response in the Problem Details format (RFC 9457).","properties":{"detail":{"description":"What went wrong with this request.","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"description":"The HTTP status code.","example":400,"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"title":{"description":"A short summary, usually the text of the HTTP status.","example":"Bad Request","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"The problem type. It is `about:blank`: the status and `code` identify the problem.","example":"about:blank","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"code":{"description":"The stable error code, when the problem has one.","example":"WA-VL-001","type":"string","uniqueKey":"code","typeLabel":"string"},"details":{"description":"Structured facts about the refusal, such as the entity or the path it concerns. Only some refusals have it.","uniqueKey":"details","typeLabel":"any"},"errors":{"description":"The fields or filters that failed validation. Only a validation or filter error has it.","uniqueKey":"errors","typeLabel":"any"},"requestId":{"description":"The ID of the request, when the problem has one. The `X-Request-ID` response header always has it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["type","title","status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","status":400,"title":"Bad Request","type":"about:blank","code":"WA-VL-001","details":"\u003cunknown>","errors":"\u003cunknown>","requestId":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The request failed on the server.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"},"b213e057-ba9b-45f7-bc58-c98594c56ed7":{"content":{"text/plain":{"schema":{"example":"Gateway Timeout","type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"Gateway Timeout"}},"exampleType":"generated"}},"description":"The operation did not finish in 30 seconds.","headers":{"X-Request-ID":{"description":"The ID of the request. It is the `X-Request-ID` value that you sent, or an ID that the server made. Give it when you report a problem.","schema":{"type":"string"}}},"exampleType":"generated"}},"security":{"3b0f5756-0c50-4c45-bdde-80dda7f0e99c":{"bearerAuth":{"description":"A personal access token, which starts with `pat_`. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"A personal access token, which starts with `pat_`. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A personal access token, which starts with `pat_`. A Parable token can call each operation that the roles of its owner allow. An MCP token can call only the read operations that are open to agents. A SQL token does not work on this API.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"parable-developers","siteName":"Parable Developers","title":"Query the Provider Pool - Parable Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T21:24:19.909Z","originalFileLocation":"api-reference/provider-pool/query-the-provider-pool.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Parable Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Query the Provider Pool - Parable Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Parable Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://parable-developers.mintlify.site/_mintlify/api/og/v2?division=Provider+pool\u0026amp;title=Query+the+Provider+Pool\u0026amp;description=Runs+one+SQL+statement+over+the+Provider+Pools+%28providers%2C+providers_quarantine%2C+providers_quality%29+and+returns+a+view+a+model+can+read.+1.+sql+is+one+read-only\u0026amp;theme=7714c4bb23dc918d9c63302a\u0026amp;signature=ab2519d3df6273512e2aeefd70f676644e331527e7a241ff93443330d0082194\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Query the Provider Pool - Parable Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://parable-developers.mintlify.site/_mintlify/api/og/v2?division=Provider+pool\u0026amp;title=Query+the+Provider+Pool\u0026amp;description=Runs+one+SQL+statement+over+the+Provider+Pools+%28providers%2C+providers_quarantine%2C+providers_quality%29+and+returns+a+view+a+model+can+read.+1.+sql+is+one+read-only\u0026amp;theme=7714c4bb23dc918d9c63302a\u0026amp;signature=ab2519d3df6273512e2aeefd70f676644e331527e7a241ff93443330d0082194\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/parable-developers/1-JQoPgYhx6OOADC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Parable Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FD4A82\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/provider-pool/query-the-provider-pool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.askparable.com/#organization\",\"name\":\"Parable Developers\",\"url\":\"https://developers.askparable.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/parable-developers/UTSJfzIbTEfjJnnx/images/logo-light.svg?fit=max\u0026auto=format\u0026n=UTSJfzIbTEfjJnnx\u0026q=85\u0026s=fe5b632595d97d15e9a8629ee338c49c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.askparable.com#website\",\"name\":\"Parable Developers\",\"url\":\"https://developers.askparable.com\",\"publisher\":{\"@id\":\"https://developers.askparable.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool#webpage\",\"url\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool\",\"name\":\"Query the Provider Pool\",\"description\":\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\",\"dateModified\":\"2026-11-13T21:24:19.909Z\",\"isPartOf\":{\"@id\":\"https://developers.askparable.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://developers.askparable.com/api-reference/agent-skills/list-powers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Provider pool\",\"item\":\"https://developers.askparable.com/api-reference/provider-pool/describe-a-pool-table\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Query the Provider Pool\",\"item\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool#apireference\",\"headline\":\"Query the Provider Pool\",\"name\":\"Query the Provider Pool\",\"description\":\"Runs one SQL statement over the Provider Pools (providers, providers_quarantine, providers_quality) and returns a view a model can read. 1. sql is one read-only statement. 2. parameters bind $1, $2 in order; identifiers cannot be bound. 3. The view holds whole leading rows within 60,000 characters, columns included, and cuts a text or binary value at 2,000; truncated says which limit applied and warnings say what to change. 4. A processing warning names each scanned table with newer ingested data still being processed. Another warning says when Provider Policies still use the preceding source-permission index. Do not treat missing rows as an ingestion or permission gap until processing finishes. 5. returnedRows counts the rows shown, never the total. 6. A 64-bit integer past 2^53 and every decimal arrive as text beside their arrowType. 7. A table in another Pool is an unknown relation (QL-PL-002).\",\"url\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool\",\"mainEntityOfPage\":{\"@id\":\"https://developers.askparable.com/api-reference/provider-pool/query-the-provider-pool#webpage\"},\"dateModified\":\"2026-11-13T21:24:19.909Z\",\"publisher\":{\"@id\":\"https://developers.askparable.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.askparable.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Parable Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Parable Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/provider-pool/query-the-provider-pool.md","siteName":"Parable Developers","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API Reference","sidebarTitle":"Overview","icon":"book","deprecated":false,"href":"/api-reference/overview"},{"title":"Field types","icon":"shield-check","deprecated":false,"href":"/platform/field-types"}]},{"group":"REST API","pages":[{"group":"Agent skills","pages":[{"title":"List Powers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/agent-skills","href":"/api-reference/agent-skills/list-powers"},{"title":"Create a Power","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/agent-skills","href":"/api-reference/agent-skills/create-a-power"},{"title":"Read a Power","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/agent-skills/{skillId}","href":"/api-reference/agent-skills/read-a-power"},{"title":"Update a Power","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/agent-skills/{skillId}","href":"/api-reference/agent-skills/update-a-power"}]},{"group":"API tokens","pages":[{"title":"List your personal access tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/api-tokens/mine","href":"/api-reference/api-tokens/list-your-personal-access-tokens"},{"title":"List the Workspace's personal access tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/api-tokens/workspace","href":"/api-reference/api-tokens/list-the-workspaces-personal-access-tokens"},{"title":"Revoke your personal access token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/api-tokens/{id}/revoke","href":"/api-reference/api-tokens/revoke-your-personal-access-token"},{"title":"Revoke a member's personal access token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/api-tokens/{id}/workspace-revoke","href":"/api-reference/api-tokens/revoke-a-members-personal-access-token"}]},{"group":"Artifacts","pages":[{"title":"Activate a publication","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/actions/activate","href":"/api-reference/artifacts/activate-a-publication"},{"title":"Delete a publication namespace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/actions/delete","href":"/api-reference/artifacts/delete-a-publication-namespace"},{"title":"Process publication uploads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/actions/finalize","href":"/api-reference/artifacts/process-publication-uploads"},{"title":"Remove a publication revision","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/actions/remove-revision","href":"/api-reference/artifacts/remove-a-publication-revision"},{"title":"Reserve a complete publication","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/actions/reserve","href":"/api-reference/artifacts/reserve-a-complete-publication"},{"title":"Read publication progress","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifact-publications/receipt","href":"/api-reference/artifacts/read-publication-progress"},{"title":"List Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/artifacts/artifacts","href":"/api-reference/artifacts/list-artifacts"},{"title":"Browse uploaded files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/artifacts/browse","href":"/api-reference/artifacts/browse-uploaded-files"},{"title":"Delete a folder of Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/artifacts/folder","href":"/api-reference/artifacts/delete-a-folder-of-artifacts"},{"title":"Publish an Artifact as a data source","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/publish-artifact","href":"/api-reference/artifacts/publish-an-artifact-as-a-data-source"},{"title":"Work out an Artifact's schema","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/run-artifact-schema-inference","href":"/api-reference/artifacts/work-out-an-artifacts-schema"},{"title":"Unpublish an Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/unpublish-artifact","href":"/api-reference/artifacts/unpublish-an-artifact"},{"title":"Replace an Artifact's schema","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/update-artifact-data-schema","href":"/api-reference/artifacts/replace-an-artifacts-schema"},{"title":"Process an uploaded Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/uploads/actions/complete","href":"/api-reference/artifacts/process-an-uploaded-artifact"},{"title":"Prepare an Artifact upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/artifacts/uploads/actions/prepare","href":"/api-reference/artifacts/prepare-an-artifact-upload"},{"title":"Read an Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/artifacts/{artifactId}","href":"/api-reference/artifacts/read-an-artifact"},{"title":"Delete an Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/artifacts/{artifactId}","href":"/api-reference/artifacts/delete-an-artifact"},{"title":"Preview an Artifact's rows","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/artifacts/{artifactId}/data-preview","href":"/api-reference/artifacts/preview-an-artifacts-rows"},{"title":"Rename or move an Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/artifacts/{id}","href":"/api-reference/artifacts/rename-or-move-an-artifact"}]},{"group":"Auth","pages":[{"title":"Turn personal access tokens on or off","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/auth/api-tokens-enabled","href":"/api-reference/auth/turn-personal-access-tokens-on-or-off"},{"title":"Turn external agent access on or off","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/auth/external-agent-access-enabled","href":"/api-reference/auth/turn-external-agent-access-on-or-off"}]},{"group":"Catalog","pages":[{"title":"Read the latest data-quality results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/catalog/table-quality-results","href":"/api-reference/catalog/read-the-latest-data-quality-results"},{"title":"Read table shapes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/catalog/table-shape-stats","href":"/api-reference/catalog/read-table-shapes"},{"title":"Read the latest drift checks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/catalog/table-spc-results","href":"/api-reference/catalog/read-the-latest-drift-checks"}]},{"group":"Connector requests","pages":[{"title":"List Provider requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/connector-requests/connector-requests","href":"/api-reference/connector-requests/list-provider-requests"},{"title":"Ask for a new Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/connector-requests/connector-requests","href":"/api-reference/connector-requests/ask-for-a-new-provider"},{"title":"Read a Provider request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/connector-requests/{id}","href":"/api-reference/connector-requests/read-a-provider-request"}]},{"group":"Connectors","pages":[{"title":"Connect a Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/connectors","href":"/api-reference/connectors/connect-a-provider"},{"title":"List Connector categories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/connectors/categories","href":"/api-reference/connectors/list-connector-categories"},{"title":"Configure a Provider connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/connectors/configure","href":"/api-reference/connectors/configure-a-provider-connection"},{"title":"Start a Provider OAuth sign-in","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/connectors/connector-oauth-start","href":"/api-reference/connectors/start-a-provider-oauth-sign-in"},{"title":"List every Tap this Workspace could use","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/connectors/tenant-connector-taps","href":"/api-reference/connectors/list-every-tap-this-workspace-could-use"},{"title":"Test a Provider's credentials","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/connectors/validate","href":"/api-reference/connectors/test-a-providers-credentials"},{"title":"Remove a Provider connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/connectors/{tenantConnectorId}","href":"/api-reference/connectors/remove-a-provider-connection"},{"title":"List a Connector's setting history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/connectors/{tenantConnectorId}/config-history","href":"/api-reference/connectors/list-a-connectors-setting-history"}]},{"group":"Devices","pages":[{"title":"List Pulse clients","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/devices","href":"/api-reference/devices/list-pulse-clients"},{"title":"List apps seen by Pulse","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/devices/seen-apps","href":"/api-reference/devices/list-apps-seen-by-pulse"},{"title":"List skipped apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/devices/skipped-apps","href":"/api-reference/devices/list-skipped-apps"},{"title":"Add a skipped app","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/devices/skipped-apps","href":"/api-reference/devices/add-a-skipped-app"},{"title":"Remove a skipped app","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/devices/skipped-apps/{id}","href":"/api-reference/devices/remove-a-skipped-app"},{"title":"Edit a skipped app","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/devices/skipped-apps/{id}","href":"/api-reference/devices/edit-a-skipped-app"},{"title":"Revoke a Pulse client","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/devices/{id}/revoke","href":"/api-reference/devices/revoke-a-pulse-client"}]},{"group":"Ingest tokens","pages":[{"title":"List ingestion tokens","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/ingest-tokens","href":"/api-reference/ingest-tokens/list-ingestion-tokens"},{"title":"Create an ingestion token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/ingest-tokens","href":"/api-reference/ingest-tokens/create-an-ingestion-token"},{"title":"Revoke an ingestion token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/ingest-tokens/{id}/revoke","href":"/api-reference/ingest-tokens/revoke-an-ingestion-token"},{"title":"Rotate an ingestion token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/ingest-tokens/{id}/rotate","href":"/api-reference/ingest-tokens/rotate-an-ingestion-token"}]},{"group":"Model policy","pages":[{"title":"Read which AI processors may use Workspace data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/model-policy","href":"/api-reference/model-policy/read-which-ai-processors-may-use-workspace-data"},{"title":"Set the Workspace's AI processors and default models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/model-policy/preferences","href":"/api-reference/model-policy/set-the-workspaces-ai-processors-and-default-models"},{"title":"Preview a change to the Workspace's AI processors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/model-policy/preferences/preview","href":"/api-reference/model-policy/preview-a-change-to-the-workspaces-ai-processors"}]},{"group":"Parable authoring","pages":[{"title":"Run a Report on a Parable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/actions/plot","href":"/api-reference/parable-authoring/run-a-report-on-a-parable"},{"title":"Read a Plot's data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/plots/data","href":"/api-reference/parable-authoring/read-a-plots-data"},{"title":"List what a Plot will return","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/parable/authoring/primaries/{rootRefId}/plots/data/manifest","href":"/api-reference/parable-authoring/list-what-a-plot-will-return"},{"title":"Get TypeScript types for a Plot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/parable/authoring/primaries/{rootRefId}/plots/data/types","href":"/api-reference/parable-authoring/get-typescript-types-for-a-plot"},{"title":"List a Parable's Refreshes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/parable/authoring/primaries/{rootRefId}/report-runs","href":"/api-reference/parable-authoring/list-a-parables-refreshes"},{"title":"Cancel a Report run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parables/authoring/primaries/{rootRefId}/report-runs/{reportRunId}/actions/cancel","href":"/api-reference/parable-authoring/cancel-a-report-run"},{"title":"Raise a Report Plot budget","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parables/authoring/primaries/{rootRefId}/report-runs/{reportRunId}/plots/{plotKey}/actions/raise-budget","href":"/api-reference/parable-authoring/raise-a-report-plot-budget"}]},{"group":"Parable artifacts","pages":[{"title":"List a Parable's Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/parable/authoring/primaries/{rootRefId}/artifacts","href":"/api-reference/parable-artifacts/list-a-parables-artifacts"},{"title":"Create a Parable Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/artifacts/actions/create","href":"/api-reference/parable-artifacts/create-a-parable-artifact"},{"title":"Delete Parable Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/artifacts/actions/delete","href":"/api-reference/parable-artifacts/delete-parable-artifacts"},{"title":"Restore Parable Artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/artifacts/actions/restore","href":"/api-reference/parable-artifacts/restore-parable-artifacts"},{"title":"Rename a Parable font family","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/artifacts/font-families/actions/rename","href":"/api-reference/parable-artifacts/rename-a-parable-font-family"},{"title":"View a Parable Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/parable/authoring/primaries/{rootRefId}/artifacts/view","href":"/api-reference/parable-artifacts/view-a-parable-artifact"},{"title":"Rename a Parable Artifact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parable/authoring/primaries/{rootRefId}/artifacts/{artifactId}/actions/rename","href":"/api-reference/parable-artifacts/rename-a-parable-artifact"}]},{"group":"Parables","pages":[{"title":"Preview a Plot","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parables/immediate-plot-query","href":"/api-reference/parables/preview-a-plot"},{"title":"Estimate a Plot query before running it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/parables/immediate-plot-query/actions/estimate","href":"/api-reference/parables/estimate-a-plot-query-before-running-it"}]},{"group":"Provider policies","pages":[{"title":"Read the Workspace's Provider Policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-policies","href":"/api-reference/provider-policies/read-the-workspaces-provider-policies"},{"title":"Read the Workspace's source permissions settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-policies/source-permissions","href":"/api-reference/provider-policies/read-the-workspaces-source-permissions-settings"},{"title":"Set the Workspace's source permissions settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/provider-policies/source-permissions","href":"/api-reference/provider-policies/set-the-workspaces-source-permissions-settings"},{"title":"List the source accounts linked to members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-policies/source-permissions/account-links","href":"/api-reference/provider-policies/list-the-source-accounts-linked-to-members"},{"title":"Link a source account to a member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-policies/source-permissions/account-links","href":"/api-reference/provider-policies/link-a-source-account-to-a-member"},{"title":"Remove a source account link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/provider-policies/source-permissions/account-links/{linkId}","href":"/api-reference/provider-policies/remove-a-source-account-link"},{"title":"Explain why one person reads one row under source permissions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-policies/source-permissions/explain","href":"/api-reference/provider-policies/explain-why-one-person-reads-one-row-under-source-permissions"},{"title":"Read how current the source permissions projection is","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-policies/source-permissions/freshness","href":"/api-reference/provider-policies/read-how-current-the-source-permissions-projection-is"},{"title":"Preview what one person reads under source permissions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-policies/source-permissions/preview","href":"/api-reference/provider-policies/preview-what-one-person-reads-under-source-permissions"},{"title":"List source accounts no member reads through","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-policies/source-permissions/unlinked-accounts","href":"/api-reference/provider-policies/list-source-accounts-no-member-reads-through"},{"title":"Set one Provider table's Provider Policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/provider-policies/{providerKey}/{tableKey}","href":"/api-reference/provider-policies/set-one-provider-tables-provider-policy"},{"title":"Check a Provider Policy before saving it","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-policies/{providerKey}/{tableKey}/preview","href":"/api-reference/provider-policies/check-a-provider-policy-before-saving-it"}]},{"group":"Provider pool","pages":[{"title":"Describe a Pool table","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-pool/describe-table","href":"/api-reference/provider-pool/describe-a-pool-table"},{"title":"Read query guidance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/provider-pool/guidance","href":"/api-reference/provider-pool/read-query-guidance"},{"title":"Plan a SQL query","description":"Plans one SQL statement against the Provider Pools without running it. 1. The input is the one Query the Provider Pool takes. 2. A statement that a run would refuse comes back as a refusal with its code and reason, such as QL-PL-002 for a name the catalog does not serve; correct the SQL from the reason. 3. No row is read, so a plan says nothing about whether the table holds rows.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-pool/plan","href":"/api-reference/provider-pool/plan-a-sql-query"},{"title":"Query the Provider Pool","deprecated":null,"version":null,"public":true,"openapi":"/api-reference/openapi.json post /api/provider-pool/query","href":"/api-reference/provider-pool/query-the-provider-pool"},{"title":"Search available data","description":"Searches the Provider Pools for the tables, columns and fields that hold the data a question needs. 1. query is plain text. 2. scope narrows by name before ranking: providers.jiracloud is one Provider, providers.jiracloud.issues.* the columns of one table. 3. kind keeps tables or columns. 4. limit and offset page through at most 500 ranked results. Results rank by keyword; matchedBy says whether meaning also matched. 5. An empty query (or *) lists instead of searching. With no scope, providers holds every Provider the caller may query and its table count. With one Provider as scope, such as providers.jiracloud, matches holds its tables by name with their descriptions and row counts, limit a page (100 by default, at most 40,000 characters), and nextCursor, sent back as cursor, reads the next page. A listing covers the providers Pool, as a search does. The search reads names and descriptions, never rows.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/provider-pool/search","href":"/api-reference/provider-pool/search-available-data"}]},{"group":"Refresh cost threshold","pages":[{"title":"Read the Workspace's Refresh cost threshold","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/refresh-cost-threshold","href":"/api-reference/refresh-cost-threshold/read-the-workspaces-refresh-cost-threshold"},{"title":"Set the Workspace's Refresh cost threshold","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/refresh-cost-threshold","href":"/api-reference/refresh-cost-threshold/set-the-workspaces-refresh-cost-threshold"}]},{"group":"Roles","pages":[{"title":"List roles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/roles/roles","href":"/api-reference/roles/list-roles"}]},{"group":"Security","pages":[{"title":"Get the Workspace encryption key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/security/encryption-key","href":"/api-reference/security/get-the-workspace-encryption-key"}]},{"group":"Workspace connector taps","pages":[{"title":"Add a Tap to a Provider connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/tenant-connector-taps/create-tenant-connector-tap","href":"/api-reference/workspace-connector-taps/add-a-tap-to-a-provider-connection"},{"title":"List Provider Pool rebuilds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/tenant-connector-taps/provider-pool-rebuilds","href":"/api-reference/workspace-connector-taps/list-provider-pool-rebuilds"},{"title":"Approve a Provider Pool rebuild","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/tenant-connector-taps/provider-pool-rebuilds/{id}/approve","href":"/api-reference/workspace-connector-taps/approve-a-provider-pool-rebuild"},{"title":"Decline a Provider Pool rebuild","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/tenant-connector-taps/provider-pool-rebuilds/{id}/decline","href":"/api-reference/workspace-connector-taps/decline-a-provider-pool-rebuild"},{"title":"List this Workspace's Taps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/tenant-connector-taps/tenant-connector-taps","href":"/api-reference/workspace-connector-taps/list-this-workspaces-taps"},{"title":"Read a Tap","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/tenant-connector-taps/{id}","href":"/api-reference/workspace-connector-taps/read-a-tap"},{"title":"Delete a Tap","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/tenant-connector-taps/{id}","href":"/api-reference/workspace-connector-taps/delete-a-tap"},{"title":"Change a Tap's settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/tenant-connector-taps/{id}","href":"/api-reference/workspace-connector-taps/change-a-taps-settings"}]},{"group":"Users","pages":[{"title":"Invite someone to the Workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/users/invitations","href":"/api-reference/users/invite-someone-to-the-workspace"},{"title":"Invite someone with the default role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/users/invitations/default-role","href":"/api-reference/users/invite-someone-with-the-default-role"},{"title":"Cancel an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/users/invitations/{inviteId}","href":"/api-reference/users/cancel-an-invitation"},{"title":"Resend an invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/users/invitations/{inviteId}/resend","href":"/api-reference/users/resend-an-invitation"},{"title":"List invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/users/invites","href":"/api-reference/users/list-invitations"},{"title":"Read your membership here","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/users/me","href":"/api-reference/users/read-your-membership-here"},{"title":"Read one person","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/users/user","href":"/api-reference/users/read-one-person"},{"title":"List people in the Workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/users/users","href":"/api-reference/users/list-people-in-the-workspace"},{"title":"Remove someone from the Workspace","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/users/{userId}","href":"/api-reference/users/remove-someone-from-the-workspace"},{"title":"Change someone's roles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/users/{userId}/roles","href":"/api-reference/users/change-someones-roles"},{"title":"Suspend or restore someone's access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/users/{userId}/status","href":"/api-reference/users/suspend-or-restore-someones-access"}]},{"group":"Catalog version 2","pages":[{"title":"Read the data catalog","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/catalog","href":"/api-reference/catalog-version-2/read-the-data-catalog"},{"title":"List Provider annotations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/catalog/provider-annotations","href":"/api-reference/catalog-version-2/list-provider-annotations"},{"title":"Read table statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v2/catalog/table-stats","href":"/api-reference/catalog-version-2/read-table-statistics"}]},{"group":"Vendors","pages":[{"title":"List Provider connections grouped by Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/connector-instances-for-vendors","href":"/api-reference/vendors/list-provider-connections-grouped-by-provider"},{"title":"List the ways of connecting to a Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/parable-vendor-groupings/{vendorSlug}","href":"/api-reference/vendors/list-the-ways-of-connecting-to-a-provider"},{"title":"Read one way of connecting to a Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/parable-vendor-groupings/{vendorSlug}/{groupingPath}","href":"/api-reference/vendors/read-one-way-of-connecting-to-a-provider"},{"title":"List Providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/parable-vendors","href":"/api-reference/vendors/list-providers"},{"title":"List Providers this Workspace has connected","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/parable-vendors-with-connectors","href":"/api-reference/vendors/list-providers-this-workspace-has-connected"},{"title":"Read a Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/parable-vendors/{slug}","href":"/api-reference/vendors/read-a-provider"},{"title":"Read product logo lookups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/product-logos","href":"/api-reference/vendors/read-product-logo-lookups"},{"title":"List Provider products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/provider-directory","href":"/api-reference/vendors/list-provider-products"},{"title":"Read why credentials failed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-credential-detail","href":"/api-reference/vendors/read-why-credentials-failed"},{"title":"List Provider connection freshness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-freshness","href":"/api-reference/vendors/list-provider-connection-freshness"},{"title":"List Provider connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-instances","href":"/api-reference/vendors/list-provider-connections"},{"title":"List Provider connections using one connection method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-instances-for-groupings/{groupingId}","href":"/api-reference/vendors/list-provider-connections-using-one-connection-method"},{"title":"List Provider connections for one Provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-instances-for-vendors/{vendorSlug}","href":"/api-reference/vendors/list-provider-connections-for-one-provider"},{"title":"Read one Provider connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-instances/{id}","href":"/api-reference/vendors/read-one-provider-connection"},{"title":"Read why a sync failed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/vendors/tenant-connector-sync-detail","href":"/api-reference/vendors/read-why-a-sync-failed"}]}]}]}]},"basePath":"","title":"Query the Provider Pool - Parable Developers","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}