Skills

List skill versions

The version history a publish or revert leaves behind.

GEThttps://cloud.generalinput.com/v1/skills/:id/versions

AuthenticationRequires skills:manage on a personal API key. A CLI session always passes.

Response

{
  "versions": [
    {
      "id": "sklv_01HX…",
      "skillId": "skl_01HX…",
      "versionNumber": 5,
      "source": "user",
      "agentRunId": null,
      "revertedFromVersionId": null,
      "revertedFromVersionNumber": null,
      "fileCount": 3,
      "sizeBytes": 4812,
      "createdAt": "2026-09-03T10:00:00.000Z"
    }
  ]
}

source is user, agent, or revert.

POSTPublish a skill bundle

Validate a staged bundle and atomically replace the live bundle. Syncs name and description from the frontmatter and snapshots a version.

POSTRevert a skill version

Make an earlier version the live bundle. Recorded as a new version.

List skill versions

Response

On this page

List skill versions

Response

On this page