Skip to main content
POST
Run a Skill by slug

Authorizations

Authorization
string
header
required

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

Path Parameters

slug
string
required

URL-safe slug of the Skill to run.

Body

application/json

Key-value map of parameter values to pass to the Skill.

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.