Skip to main content
GET
List skills
Search with q (name, slug, or description) and filter with status (active or draft). Page with limit (1–100, default 50) and cursor; see Pagination. Each item has the skill’s slug, its inputs, health over the last 20 runs, last_run_at, and api_endpoint / runs_endpoint to run it. For the full contract, call Get a skill. Needs skills:read. MCP tool: list_skills.

Authorizations

Authorization
string
header
required

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

Query Parameters

q
string | null

Text in the name, slug or description

Maximum string length: 200
status
enum<string> | null
Available options:
active,
draft
limit
integer
default:50

Items per page, 1–100.

Required range: 1 <= x <= 100
cursor
string | null

next_cursor of the previous page

Response

A page of skills.

skills
SkillListItem · object[]
required
has_more
boolean
required
read-only

True when there is a next page (next_cursor is not null).

next_cursor
string | null

Pass as ?cursor= for the next page; null on the last page.