curl -X POST https://app.runtm.com/api/knowledge/integrations/ki_01J...:test \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
integration_id = "ki_01J..."
resp = requests.post(
f"https://app.runtm.com/api/knowledge/integrations/{integration_id}:test",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
print(resp.json())
const integrationId = "ki_01J...";
const resp = await fetch(
`https://app.runtm.com/api/knowledge/integrations/${integrationId}:test`,
{
method: "POST",
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "active",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": "2026-05-09T19:05:00Z",
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": true,
"detail": null
}
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "error",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": null,
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": false,
"detail": "Service account does not have bigquery.jobs.create permission on project my-gcp-project."
}
Knowledge
Test Knowledge Integration
Run a connectivity check against a knowledge integration.
POST
/
api
/
knowledge
/
integrations
/
{integration_id}
:test
curl -X POST https://app.runtm.com/api/knowledge/integrations/ki_01J...:test \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
integration_id = "ki_01J..."
resp = requests.post(
f"https://app.runtm.com/api/knowledge/integrations/{integration_id}:test",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
print(resp.json())
const integrationId = "ki_01J...";
const resp = await fetch(
`https://app.runtm.com/api/knowledge/integrations/${integrationId}:test`,
{
method: "POST",
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "active",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": "2026-05-09T19:05:00Z",
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": true,
"detail": null
}
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "error",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": null,
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": false,
"detail": "Service account does not have bigquery.jobs.create permission on project my-gcp-project."
}
Tests the stored credentials for a knowledge integration by making a lightweight call to the upstream provider.
Returns the integration resource along with a health check result.
Required scope:
integrations:read
Requires organization context via the
X-Organization-Id header.The integration resource. See List for the full resource shape.
curl -X POST https://app.runtm.com/api/knowledge/integrations/ki_01J...:test \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
import requests
integration_id = "ki_01J..."
resp = requests.post(
f"https://app.runtm.com/api/knowledge/integrations/{integration_id}:test",
headers={
"Authorization": "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
)
print(resp.json())
const integrationId = "ki_01J...";
const resp = await fetch(
`https://app.runtm.com/api/knowledge/integrations/${integrationId}:test`,
{
method: "POST",
headers: {
Authorization: "Bearer runtm_xxx",
"X-Organization-Id": "org_abc123",
},
}
);
const data = await resp.json();
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "active",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": "2026-05-09T19:05:00Z",
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": true,
"detail": null
}
{
"integration": {
"id": "ki_01J...",
"organization_id": "org_abc123",
"user_id": null,
"provider": "bigquery",
"auth_method": "service_account",
"display_name": "Production warehouse",
"status": "error",
"has_credentials": true,
"has_oauth_refresh": false,
"oauth_access_expires_at": null,
"provider_metadata": { "project_id": "my-gcp-project" },
"default_mode": "ask",
"tool_permissions": {},
"connected_by_user_id": "usr_xyz",
"last_used_at": null,
"created_at": "2026-04-20T09:30:00Z",
"updated_at": "2026-05-09T19:05:00Z"
},
"ok": false,
"detail": "Service account does not have bigquery.jobs.create permission on project my-gcp-project."
}