Execute a skill once
POST /skills/{action_id}/execute
POST
/skills/{action_id}/execute
Run a skill once and return the execution result.
Pre-flight GET enforces the action is a skill (not a workflow) so
the skill execute surface stays sealed. org_id is pinned;
triggered_by is the key’s member (_runner_identity), never the body.
Authorizations
Parameters
Path Parameters
action_id
required
Skill action_id.
string
Skill action_id.
Header Parameters
Request Body
ExecutionCreateRequest body.
object
key
additional properties
any
Responses
200
Successful Response
object
key
additional properties
any
202
The run request reached the skill service but no reply came back in time. outcome is started (the run was found; execution_id is set) or unknown (check possible_executions before retrying). Never a failure.
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string