Resolido Docs
Skills

Run action skill

POST
/skills/{skillId}/run

Run a saved action API skill (refill, restart, refund…) for real, exactly as the AI agent would. Two-step confirmation: the first call returns a summary, repeat with confirmationToken after the user agreed. Owner/admin.

Authorization

bearer skills:write
headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: skills:write

Path Parameters

skillId*string
Match^custom_[a-z0-9]+$

Request Body

application/json
  1. body
testInputs?

Tool arguments, e.g. {"orderNumber": "1042"} – the same fields the AI fills in.

Default{}
confirmationToken?string

Destructive operations run in two steps: call without this field, show the returned summary to the user, and only after their explicit approval call again with the returned confirmation_token.

Lengthlength <= 512

Response Body

Success

application/json
  1. response
result*string

The tool result the AI agent would receive (API response or error).

durationMs*number
curl -X POST "https://example.com/skills/string/run" \  -H "Content-Type: application/json" \  -d '{}'
{  "result": "string",  "durationMs": 0}