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 versions for an agent
      • GETGet the published version for an agent
      • GETGet a specific agent version
      • POSTPublish a specific agent version
Dashboard
LogoLogo
Runtype APIAgent Versions

List versions for an agent

GET
/v1/agent-versions/:agentId
GET
/v1/agent-versions/:agentId
$curl https://api.runtype.com/v1/agent-versions/agentId \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json"
1{
2  "agentId": "agent_9f8b7c6d5e4a3b2c1d0e",
3  "publishedVersionId": "ver_123abc456def789ghi",
4  "draftVersionId": "ver_987zyx654wvu321tsr",
5  "versions": [
6    {
7      "id": "ver_123abc456def789ghi",
8      "versionNumber": 3,
9      "versionType": "published",
10      "label": "Release 3.0",
11      "notes": "Major update with improved NLP capabilities and bug fixes.",
12      "configSummary": "Updated intent recognition and response generation modules.",
13      "createdAt": "2024-05-10T09:15:00Z"
14    }
15  ]
16}
Was this page helpful?
Previous

Get the published version for an agent

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

agentIdstringRequired

Query parameters

typeenumOptional
Allowed values:

Response

Agent versions list
agentIdstring
publishedVersionIdstring or null
draftVersionIdstring or null
versionslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error