Skip to main content
POST
Resolve public skills to install, without an API key

Authorizations

Authorization
string
header
required

Enter your API key (e.g. dai_sk_test_key_001)

Body

application/json
items
any[]
required

Up to 100 items (20 without an API key), one result each. An item is {"ref": ..., "version": ...} or {"skill_id": ..., "version_id": ...}. ref is a skill id, a registry name or url_slug (your organization's own skills first, then skills it Uses, then public skills) or an install name. version is "latest" (default) or a number; version_id names one exact version.

taken
Taken · object | null

Each install name (folder) the project already uses, mapped to the skill id it holds, or to null for a folder the skills engine does not manage. A skill already in the map keeps its name; otherwise the registry picks around them. Names chosen for earlier items count as taken for later ones.

formats
integer[] | null

Up to 8 SKILL.md formats the client reads (default [1]). The highest one this registry renders is used; when it renders none of them, the whole request is refused with format_unsupported.

channel
string | null

Who is resolving (cli, sdk, ...).

purpose
string | null

Why (add, update, ...).

Response

Successful Response

items
ResolveResult · object[]
required