Skip to content

Execute a skill once

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 defaults to the caller’s user id.

Authorizations

Parameters

Path Parameters

action_id
required

Skill action_id.

string
>= 1 characters

Skill action_id.

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body

ExecutionCreateRequest body.

object
key
additional properties
any

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string