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
      • POSTPublish a specific agent version
      • GETGet the published version for an agent
      • GETGet 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: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "agentId": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3  "draftVersionId": "v123-draft-4567",
4  "publishedVersionId": "v122-published-3456",
5  "versions": [
6    {
7      "configSummary": "Initial release with basic NLP capabilities",
8      "createdAt": "2024-05-10T09:15:00Z",
9      "id": "v122-published-3456",
10      "label": "Version 1.2.2",
11      "notes": "Stable release with improved intent recognition",
12      "versionNumber": 122,
13      "versionType": "published"
14    }
15  ]
16}
Was this page helpful?
Previous

Publish a specific agent version

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

agentIdstringRequired

Query parameters

typeenumOptional
Allowed values:

Response

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

Errors

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