Cloudflare API | Workflows › update

API Reference

Account & User Management

Resource Sharing

AI

Certificate Management

Certificate Authorities

Client Certificates

Custom Certificates

Custom Hostnames

Keyless Certificates

MTLS Certificates

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

Cloudflare One

DNS

Account Custom Nameservers

Domain/Zone Management

IP Addresses

Media

Networking

Magic Cloud Networking

Magic Network Monitoring

Network Interconnects

Observability

Security Center

Radar

Routing & Performance

Rules

Cloud Connector

Managed Transforms

URL Normalization

Security

Schema Validation

Content Scanning

Leaked Credential Checks

Token Validation

Storage & Databases

R2 Data Catalog

Threat Intelligence

Brand Protection

Workers & Pages

Browser Rendering

Durable Objects

Workers For Platforms

List all Workflows

Get Workflow details

Create/modify Workflow

Deletes a Workflow

Shared

Workflows

Workflows

Methods

client.workflows.list(, ):

V4PagePaginationArray

<

WorkflowListResponse

>

get/accounts/{account_id}/workflows

List all Workflows

client.workflows.get(, , ):

WorkflowGetResponse

get/accounts/{account_id}/workflows/{workflow_name}

Get Workflow details

client.workflows.update(, , ):

WorkflowUpdateResponse

put/accounts/{account_id}/workflows/{workflow_name}

Create/modify Workflow

Security

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

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Workers Scripts Write

Parameters

workflowName: string

(maxLength: 64, minLength: 1)

params:

WorkflowUpdateParams

account_id: string

Path param

class_name: string

(maxLength: 255, minLength: 1)

Body param

script_name: string

(maxLength: 255, minLength: 1)

Body param

Returns

WorkflowUpdateResponse{

id: string

(format: uuid)

class_name: string

created_on: string

(format: date-time)

is_deleted: number

modified_on: string

(format: date-time)

name: string

(maxLength: 64, minLength: 1)

script_name: string

terminator_running: number

triggered_on: string | null

(format: date-time)

version_id: string

(format: uuid)

Request example

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const workflow = await client.workflows.update('x', {
  account_id: 'account_id',
  class_name: 'x',
  script_name: 'x',
});

console.log(workflow.id);

200Example

{
  "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",
    "is_deleted": 0,
    "modified_on": "2019-12-27T18:11:19.117Z",
    "name": "x",
    "script_name": "script_name",
    "terminator_running": 0,
    "triggered_on": "2019-12-27T18:11:19.117Z",
    "version_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
  },
  "success": true,
  "result_info": {
    "count": 0,
    "per_page": 0,
    "total_count": 0,
    "cursor": "cursor",
    "page": 0
  }
}

client.workflows.delete(, , ):

WorkflowDeleteResponse

delete/accounts/{account_id}/workflows/{workflow_name}

Deletes a Workflow. This only deletes the Workflow and does not delete or modify any Worker associated to this Workflow or bounded to it.

Instances

Workflows.Instances

Methods

client.workflows.instances.list(, , ):

V4PagePaginationArray

<

InstanceListResponse

>

get/accounts/{account_id}/workflows/{workflow_name}/instances

List of workflow instances

client.workflows.instances.get(, , , ):

InstanceGetResponse

get/accounts/{account_id}/workflows/{workflow_name}/instances/{instance_id}

Get logs and status from instance

client.workflows.instances.create(, , ):

InstanceCreateResponse

post/accounts/{account_id}/workflows/{workflow_name}/instances

Create a new workflow instance

client.workflows.instances.bulk(, , ):

<

InstanceBulkResponse

>

post/accounts/{account_id}/workflows/{workflow_name}/instances/batch

Batch create new Workflow instances

Workflows Instances

Events

Workflows.Instances.Events

Methods

client.workflows.instances.events.create(, , , , ):

EventCreateResponse

post/accounts/{account_id}/workflows/{workflow_name}/instances/{instance_id}/events/{event_type}

Send event to instance

Workflows Instances

Status

Workflows.Instances.Status

Methods

client.workflows.instances.status.edit(, , , ):

StatusEditResponse

patch/accounts/{account_id}/workflows/{workflow_name}/instances/{instance_id}/status

Change status of instance

Versions

Workflows.Versions

Methods

client.workflows.versions.list(, , ):

V4PagePaginationArray

<

VersionListResponse

>

get/accounts/{account_id}/workflows/{workflow_name}/versions

List deployed Workflow versions

client.workflows.versions.get(, , , ):

VersionGetResponse

get/accounts/{account_id}/workflows/{workflow_name}/versions/{version_id}

Get Workflow version details