Skip to main content
GET
Get a skill
The fields you will use most: A public skill needs no key. A private skill returns 404 to anyone who may not run it. MCP tool: get_skill.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Path Parameters

slug
string
required

Response

The Skill and its contract.

Everything PublishedSkillPublic has, plus what an integrator needs to call it.

id
string
required
owner_id
string
required
name
string
required
slug
string
required
description
string | null
required
version
string
required
visibility
enum<string>
required

Skill visibility settings.

Available options:
private,
public
status
enum<string>
required

Skill lifecycle status.

Available options:
draft,
active,
published,
deprecated
parameters
SkillParameter · object[]
required
output_schema
Output Schema · object
required
category
string | null
required
tags
string[]
required
total_runs
integer
required
total_clones
integer
required
is_official
boolean
required
created_at
string<date-time>
required
published_at
string<date-time> | null
required
creator_id
string
required
workspace_id
string | null
validation_status
string | null
validation_reason
string | null
validation_diagnosis
Validation Diagnosis · object | null
validated_at
string<date-time> | null
image_url
string | null
target_domain
string | null
sample_output
Sample Output · object
start_url
string | null
rating
number | null
user_rating
number | null
has_cloned
boolean
default:false
user_cloned_skill_id
string | null
update_frequency
string
default:manual
data_retention_days
integer
default:90
last_run_at
string<date-time> | null
next_run_at
string<date-time> | null
health_status
string
default:unknown
success_rate
number
default:0
last_run
RunSummary · object | null

The last finished run of a skill or workflow, as a list row shows it.

running_run_id
string | null
smart_suggestions
Smart Suggestions · object | null
enriched_fields
string[]
expected_shapes
Expected Shapes · object
default_max_results
integer | null
default_max_pages
integer | null
browser_type
string | null
profile_id
string | null
login_id
string | null
skill_type
string | null
updated_at
string<date-time> | null
proxy_config
string | null
scrape_mode
string | null
scrape_mode_applies
boolean
default:false
creator_name
string | null
creator_avatar_url
string | null
cloned_from_id
string | null
cloned_from_name
string | null
is_monetized
boolean
default:false
base_run_cost
integer
default:0
avg_duration_seconds
number | null
clones_this_week
integer
default:0
uses_remote_browser
boolean
default:false
llm_model
string
default:GEMINI 3.5 FLASH
total_ratings
integer
default:0
rating_breakdown
Rating Breakdown · object | null
reviews
Reviews · object[]
api_endpoint
string | null
config_id
string | null
health
SkillHealth · object | null
input_schema
Input Schema · object
output_json_schema
Output Json Schema · object
reliability
SkillReliability · object

Lifetime aggregates kept on the skill row (updated by every terminal run), plus the rolling window over the last 20 runs (app/published_skills/reliability.py).

runs_endpoint
string | null
recipe_version
integer | null
pinned_recipe_version
integer | null
versions_endpoint
string | null
fast_path
string | null
tiers
Tiers · object