curl https://app.runtm.com/api/knowledge/catalog \
-H "Authorization: Bearer runtm_xxx"
import requests
resp = requests.get(
"https://app.runtm.com/api/knowledge/catalog",
headers={"Authorization": "Bearer runtm_xxx"},
)
print(resp.json())
const resp = await fetch("https://app.runtm.com/api/knowledge/catalog", {
headers: { Authorization: "Bearer runtm_xxx" },
});
const data = await resp.json();
{
"providers": [
{
"id": "bigquery",
"display_name": "BigQuery",
"tagline": "Query Google BigQuery datasets",
"description": "Connect BigQuery to let agents query your data warehouse.",
"category": "data",
"icon": "bigquery",
"accent_color": "#4285F4",
"docs_url": "https://cloud.google.com/bigquery/docs",
"auth_methods": [
{
"id": "service_account",
"display_name": "Service Account",
"description": "Authenticate with a GCP service account key.",
"auth_kind": "static",
"oauth_scopes": [],
"credential_schema": {
"type": "object",
"properties": {
"service_account_json": { "type": "string" }
},
"required": ["service_account_json"]
}
}
],
"tools": [
{
"id": "query",
"name": "Run SQL Query",
"description": "Execute a read-only SQL query against BigQuery.",
"kind": "read",
"default_permission": "ask"
}
]
}
]
}
Knowledge
Knowledge Catalog
List every available knowledge provider and its capabilities.
GET
/
api
/
knowledge
/
catalog
curl https://app.runtm.com/api/knowledge/catalog \
-H "Authorization: Bearer runtm_xxx"
import requests
resp = requests.get(
"https://app.runtm.com/api/knowledge/catalog",
headers={"Authorization": "Bearer runtm_xxx"},
)
print(resp.json())
const resp = await fetch("https://app.runtm.com/api/knowledge/catalog", {
headers: { Authorization: "Bearer runtm_xxx" },
});
const data = await resp.json();
{
"providers": [
{
"id": "bigquery",
"display_name": "BigQuery",
"tagline": "Query Google BigQuery datasets",
"description": "Connect BigQuery to let agents query your data warehouse.",
"category": "data",
"icon": "bigquery",
"accent_color": "#4285F4",
"docs_url": "https://cloud.google.com/bigquery/docs",
"auth_methods": [
{
"id": "service_account",
"display_name": "Service Account",
"description": "Authenticate with a GCP service account key.",
"auth_kind": "static",
"oauth_scopes": [],
"credential_schema": {
"type": "object",
"properties": {
"service_account_json": { "type": "string" }
},
"required": ["service_account_json"]
}
}
],
"tools": [
{
"id": "query",
"name": "Run SQL Query",
"description": "Execute a read-only SQL query against BigQuery.",
"kind": "read",
"default_permission": "ask"
}
]
}
]
}
Returns the full catalog of knowledge providers with their auth methods, tools, and display metadata.
The catalog is resolved from code at import time - no database queries are involved.
Required scope:
integrations:read
CatalogProviderResource[]
required
List of available knowledge providers.
Show CatalogProviderResource
Show CatalogProviderResource
string
required
Provider identifier (e.g.
"bigquery").string
required
Human-readable name.
string
required
Short tagline for the provider picker.
string
required
Full description.
string
required
Grouping category.
string
required
Icon identifier.
string
required
CSS color value.
string
Link to provider documentation.
CatalogAuthMethodResource[]
required
curl https://app.runtm.com/api/knowledge/catalog \
-H "Authorization: Bearer runtm_xxx"
import requests
resp = requests.get(
"https://app.runtm.com/api/knowledge/catalog",
headers={"Authorization": "Bearer runtm_xxx"},
)
print(resp.json())
const resp = await fetch("https://app.runtm.com/api/knowledge/catalog", {
headers: { Authorization: "Bearer runtm_xxx" },
});
const data = await resp.json();
{
"providers": [
{
"id": "bigquery",
"display_name": "BigQuery",
"tagline": "Query Google BigQuery datasets",
"description": "Connect BigQuery to let agents query your data warehouse.",
"category": "data",
"icon": "bigquery",
"accent_color": "#4285F4",
"docs_url": "https://cloud.google.com/bigquery/docs",
"auth_methods": [
{
"id": "service_account",
"display_name": "Service Account",
"description": "Authenticate with a GCP service account key.",
"auth_kind": "static",
"oauth_scopes": [],
"credential_schema": {
"type": "object",
"properties": {
"service_account_json": { "type": "string" }
},
"required": ["service_account_json"]
}
}
],
"tools": [
{
"id": "query",
"name": "Run SQL Query",
"description": "Execute a read-only SQL query against BigQuery.",
"kind": "read",
"default_permission": "ask"
}
]
}
]
}