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

Get a specific flow version

GET
/v1/flow-versions/:flowId/:versionId
GET
/v1/flow-versions/:flowId/:versionId
$curl https://api.runtype.com/v1/flow-versions/flowId/versionId \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json"
1{
2 "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
3 "flowId": "a1b2c3d4e5f6g7h8i9j0",
4 "versionNumber": 3,
5 "versionType": "production",
6 "flowConfig": {
7 "steps": [
8 {
9 "id": "step1",
10 "type": "trigger",
11 "config": {
12 "event": "user_signup"
13 }
14 },
15 {
16 "id": "step2",
17 "type": "action",
18 "config": {
19 "service": "email",
20 "templateId": "welcome_01"
21 }
22 }
23 ],
24 "settings": {
25 "retryOnFailure": true,
26 "maxRetries": 3
27 }
28 },
29 "label": "User Signup Welcome Flow",
30 "notes": "This flow triggers a welcome email when a user signs up.",
31 "createdAt": "2024-05-20T10:15:30Z"
32}
Was this page helpful?
Previous

Publish a specific flow version

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

flowIdstringRequired
versionIdstringRequired

Response

Flow version detail
idstring
flowIdstring
versionNumberinteger
versionTypestring
flowConfigmap from strings to any or null
labelstring or null
notesstring or null
createdAtstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error