Skip to content
Start here

List deployed Workflow versions

client.Workflows.Versions.List(ctx, workflowName, params) (*V4PagePaginationArray[VersionListResponse], error)
GET/accounts/{account_id}/workflows/{workflow_name}/versions

Lists all deployed versions of a workflow.

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
Accepted Permissions (at least one required)
Workers Tail ReadWorkers Scripts WriteWorkers Scripts Read
ParametersExpand Collapse
workflowName string
maxLength64
minLength1
params VersionListParams
AccountID param.Field[string]

Path param

Page param.Field[float64]Optional

Query param

minimum1
PerPage param.Field[float64]Optional

Query param

maximum100
minimum1
ReturnsExpand Collapse
type VersionListResponse struct{…}
ID string
formatuuid
ClassName string
CreatedOn Time
formatdate-time
HasDag bool
Language VersionListResponseLanguage

The programming language of the workflow implementation

One of the following:
const VersionListResponseLanguageJavascript VersionListResponseLanguage = "javascript"
const VersionListResponseLanguagePython VersionListResponseLanguage = "python"
ModifiedOn Time
formatdate-time
WorkflowID string
formatuuid
DefaultRetention VersionListResponseDefaultRetentionOptional
ErrorRetention int64Optional

Default error retention in milliseconds.

SuccessRetention int64Optional

Default success retention in milliseconds.

Limits VersionListResponseLimitsOptional
Steps int64Optional
minimum1

List deployed Workflow versions

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/workflows"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  page, err := client.Workflows.Versions.List(
    context.TODO(),
    "x",
    workflows.VersionListParams{
      AccountID: cloudflare.F("account_id"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
{
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "class_name": "class_name",
      "created_on": "2019-12-27T18:11:19.117Z",
      "has_dag": true,
      "language": "javascript",
      "modified_on": "2019-12-27T18:11:19.117Z",
      "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "default_retention": {
        "error_retention": 0,
        "success_retention": 0
      },
      "limits": {
        "steps": 1
      }
    }
  ],
  "success": true,
  "result_info": {
    "count": 0,
    "per_page": 0,
    "total_count": 0,
    "cursor": "cursor",
    "page": 0,
    "total_pages": 0
  }
}
Returns Examples
{
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "class_name": "class_name",
      "created_on": "2019-12-27T18:11:19.117Z",
      "has_dag": true,
      "language": "javascript",
      "modified_on": "2019-12-27T18:11:19.117Z",
      "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "default_retention": {
        "error_retention": 0,
        "success_retention": 0
      },
      "limits": {
        "steps": 1
      }
    }
  ],
  "success": true,
  "result_info": {
    "count": 0,
    "per_page": 0,
    "total_count": 0,
    "cursor": "cursor",
    "page": 0,
    "total_pages": 0
  }
}