curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/tools" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"provider_slugs": ["notion"]}'
runtm-api session load-tools a6414511-4430-4e1f-8c51-8ea8824dadec notion
{
"loaded": [{"id": "notion", "name": "Notion"}],
"needs_auth": [],
"skipped": []
}
Capabilities
Load Tools
Hot-load tools into a running session
POST
/
api
/
sessions
/
{session_id}
/
tools
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/tools" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"provider_slugs": ["notion"]}'
runtm-api session load-tools a6414511-4430-4e1f-8c51-8ea8824dadec notion
{
"loaded": [{"id": "notion", "name": "Notion"}],
"needs_auth": [],
"skipped": []
}
Loads tools (knowledge integrations) into a running sandbox. Unlike skills and MCP servers, tools are addressed by provider slug (
notion, bigquery), not directive ID. Providers with no stored credentials are reported under needs_auth.
Required scope: sessions:write
Path Parameters
string
required
The session ID.
Request Body
string[]
required
Provider slugs of the tools to load.
Response
array
{id, name} for each tool that loaded.string[]
Providers skipped because no credentials are connected.
string[]
Unknown provider slugs.
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/tools" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"provider_slugs": ["notion"]}'
runtm-api session load-tools a6414511-4430-4e1f-8c51-8ea8824dadec notion
{
"loaded": [{"id": "notion", "name": "Notion"}],
"needs_auth": [],
"skipped": []
}