Skip to main content
GET
Get a Skill's contract

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.

Response

The Skill and its contract.

The Skill's public details plus its typed contract. Other public fields (description, parameters, output_schema, category, tags, ratings, and so on) are also returned.

id
string
name
string
slug
string
description
string | null
visibility
enum<string>
Available options:
public,
private
status
string
api_endpoint
string
Example:

"/v1/skills/austin-dentists/run"

input_schema
object

JSON Schema (draft 2020-12) for the inputs. Unknown keys are refused.

output_json_schema
object

JSON Schema for the run result, including each row.

reliability
object
runs_endpoint
string
Example:

"/v1/skills/austin-dentists/runs"

recipe_version
integer | null

The live recipe version.

pinned_recipe_version
integer | null

The pinned version, or null.

versions_endpoint
string
Example:

"/v1/skills/austin-dentists/versions"

fast_path
string | null

For example fast path: direct HTTP, ~0.3s. Null when the skill always uses the browser.

tiers
object

Per route: attempts, ok, success_rate, typical_seconds, status.