curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/skills" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"skill_ids": ["dir_9f3c1a"]}'
runtm-api session load-skills a6414511-4430-4e1f-8c51-8ea8824dadec dir_9f3c1a
{
"loaded": [{"id": "dir_9f3c1a", "name": "outbound-writing"}],
"applied_integrations": [],
"unmet_requirements": [],
"skipped": []
}
Capabilities
Load Skills
Hot-load org skills into a running session
POST
/
api
/
sessions
/
{session_id}
/
skills
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/skills" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"skill_ids": ["dir_9f3c1a"]}'
runtm-api session load-skills a6414511-4430-4e1f-8c51-8ea8824dadec dir_9f3c1a
{
"loaded": [{"id": "dir_9f3c1a", "name": "outbound-writing"}],
"applied_integrations": [],
"unmet_requirements": [],
"skipped": []
}
Loads skills into a running sandbox without a template rebuild: the difference between seconds and minutes when iterating. IDs are agent-directive IDs (from List Skills), not names. The sandbox must be running.
Required scope:
sessions:write
Path Parameters
string
required
The session ID.
Request Body
string[]
required
Agent-directive IDs of the skills to load.
Response
array
{id, name} for each skill that loaded.string[]
Tool integrations applied because a loaded skill requires them.
string[]
Requirements that could not be satisfied (for example, a tool with no credentials).
string[]
IDs that were unknown or not skills.
curl -X POST "https://app.runtm.com/api/cloud/sessions/a6414511-4430-4e1f-8c51-8ea8824dadec/skills" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123" \
-H "Content-Type: application/json" \
-d '{"skill_ids": ["dir_9f3c1a"]}'
runtm-api session load-skills a6414511-4430-4e1f-8c51-8ea8824dadec dir_9f3c1a
{
"loaded": [{"id": "dir_9f3c1a", "name": "outbound-writing"}],
"applied_integrations": [],
"unmet_requirements": [],
"skipped": []
}