For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList skills
      • POSTCreate a skill
      • POSTBind a skill to an agent
      • GETList an agent's skill bindings
      • DELUnbind a skill from an agent
      • POSTImport a SKILL.md
      • POSTPropose a skill (deployed-agent data plane)
      • GETGet a skill
      • PUTAppend a new skill version
      • DELDelete a skill
      • GETList a skill's versions
      • POSTPublish a skill version
Dashboard
LogoLogo
Runtype APISkills

List a skill's versions

GET
/v1/skills/:id/versions
GET
/v1/skills/:id/versions
$curl https://api.runtype.com/v1/skills/id/versions \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "data": [
3    {
4      "version": "2.3.1",
5      "releasedAt": "2024-05-20T10:15:30Z",
6      "changelog": "Improved natural language understanding and fixed minor bugs.",
7      "status": "published"
8    },
9    {
10      "version": "2.3.0",
11      "releasedAt": "2024-04-15T09:00:00Z",
12      "changelog": "Added support for multi-turn conversations.",
13      "status": "published"
14    },
15    {
16      "version": "2.2.5-beta",
17      "releasedAt": "2024-03-10T14:45:00Z",
18      "changelog": "Beta release with experimental sentiment analysis feature.",
19      "status": "beta"
20    }
21  ]
22}

List all versions of a skill, newest first. (The same array is embedded in GET /{id}; this endpoint exposes it standalone for clients that only need the version history.)

Was this page helpful?
Previous

Publish a skill version

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Response

Versions
datalist of maps from strings to any

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error