Skills
Create API skill
POST
Create a custom API skill (e.g. order status lookup) and optionally enable it for agents. Owner/admin.
bearer skills:writeheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: skills:write
application/json- body
name*stringLength
2 <= length <= 100description?stringWhat the skill does – the AI reads it to decide when to call it.
Length
length <= 1000instructions?stringHow the AI should use the result.
Length
length <= 100000effect?stringread = only looks data up; action = changes something (refill, restart, refund…). Debug replays never call action skills. Default: GET = read, POST = action.
Value in
"read""action"api*agentIds?array<>Items
items <= 50Default
[]Success
application/json- response
skillId*stringenabledFor*array<string>curl -X POST "https://example.com/skills" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "api": { "url": "http://example.com" } }'{ "skillId": "string", "enabledFor": [ "string" ]}