v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0163155274.5 KB
skills

Sync project skills from the lock file

Restore a project's installed skills to match toolhive.lock.yaml

post/api/v1beta/skills/sync

Request body

object required
OR

Response

OK

already_currentstring[]

AlreadyCurrent lists skills that already matched the lock file.

driftedstring[]

Drifted lists skills whose on-disk contentDigest differed from the lock file. Normally these are reinstalled to match it; when Check is set, nothing is written and this field reports the drift only.

installedstring[]

Installed lists skills that were installed or reinstalled to match the lock file.

missingstring[]

Missing lists lock entries with no corresponding install record at all — the fresh-clone state. Normally these are installed at their pinned reference; when Check is set, nothing is written and this field reports the gap only.

never_managedstring[]

NeverManaged lists project-scoped skills never recorded as lock-managed.

prunedstring[]

Pruned lists removed-from-lock skills that were uninstalled because Prune was set.

removed_from_lockstring[]

RemovedFromLock lists previously managed skills absent from the lock file.