Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.selftune.dev/llms.txt

Use this file to discover all available pages before exploring further.

All registry endpoints require API key authentication. Plan-gated endpoints require the organization to be on the specified plan or higher.

​
Create entry

POST /api/v1/registry
Create a new registry entry with its first version. Requires Pro plan + registry:push permission. Content-Type: multipart/form-data
FieldTypeDescription
metadataJSON string{ name, entry_type, description, version, change_summary, file_manifest, content_hash }
archiveFiletar.gz archive of the skill folder

​
Response (201)

{
  "entry": { "id": "...", "name": "deploy", "entry_type": "skill" },
  "version": { "id": "...", "version": "1.0.0", "content_hash": "abc123" }
}

​
List entries

GET /api/v1/registry
Returns all registry entries for the authenticated organization.

​
Get entry detail

GET /api/v1/registry/:id
Returns entry metadata, all versions with quality data, and installation count.

​
Push version

POST /api/v1/registry/:id/versions
Push a new version for an existing entry. Same multipart format as create. Requires Pro plan.

​
List versions

GET /api/v1/registry/:id/versions
Returns version timeline ordered by push date (newest first).

​
Rollback

POST /api/v1/registry/:id/rollback
Rollback to a previous version. Requires Pro plan + registry:rollback permission. 
{
  "target_version": "1.0.0",
  "reason": "v1.1.0 caused regressions"
}
Both fields are optional. If target_version is omitted, rolls back to the most recent previous version.

​
Record installation

POST /api/v1/registry/:id/install
Record that a skill was installed. Requires Pro plan + registry:install permission. 
{
  "install_path": ".claude/skills/deploy/",
  "device_id": "macbook-pro"
}

​
List installations

GET /api/v1/registry/:id/installations
Returns which team members have the entry installed, their versions, and sync status. Requires Team plan.

​
Check sync

GET /api/v1/registry/sync/check
POST /api/v1/registry/sync
Lightweight version check. Accepts a list of { entry_id, current_version_hash } pairs. Returns which entries have updates available, with presigned download URLs for changed versions. 
{
  "installations": [
    { "entry_id": "...", "current_version_hash": "abc123" }
  ]
}

​
List installed

GET /api/v1/registry/installed
Returns the authenticated user’s installed entries with sync status.

​
Delete entry

DELETE /api/v1/registry/:id
Remove a registry entry and all its versions. Requires registry:delete (owner) permission.