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 a flow
      • GETGet the published version for a flow
      • GETGet a specific flow version
      • POSTPublish a specific flow version
Dashboard
LogoLogo
Runtype APIFlow Versions

List versions for a flow

GET
/v1/flow-versions/:flowId
GET
/v1/flow-versions/:flowId
$curl https://api.runtype.com/v1/flow-versions/flowId \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json"
1{
2 "flowId": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3 "publishedVersionId": "v1234567890abcdef",
4 "versions": [
5 {
6 "id": "v1234567890abcdef",
7 "versionNumber": 3,
8 "versionType": "published",
9 "label": "Release Candidate",
10 "notes": "Finalized flow for Q2 release",
11 "stepSummary": "Input validation, data processing, output generation",
12 "stepCount": 5,
13 "createdAt": "2024-05-20T15:45:00Z"
14 }
15 ]
16}
Was this page helpful?
Previous

Get the published version for a flow

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

flowIdstringRequired

Query parameters

typeenumOptional
Allowed values:

Response

Flow versions list
flowIdstring
publishedVersionIdstring or null
versionslist of objects

Errors

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