Skip to main content
POST
Run a Skill by ID

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.

Body

application/json
skill_id
string
required

The unique identifier of the published Skill to execute. Skill IDs follow the format skl_...

Example:

"skl_b281b8165a23"

parameters
object

Key-value map of parameter values to pass to the Skill. Parameter names must match those defined in the Skill's configuration.

Example:

Response

Skill executed successfully

status
enum<string>

Terminal state of the run.

Available options:
completed,
failed
data
object[] | null

Structured JSON output produced by the Skill, validated against the Skill's output schema. Null if the run failed.

count
integer

Number of items in data.

execution_time_ms
integer

Total wall-clock execution time in milliseconds.

error
string | null

Error message if the run failed, otherwise null.