--- title: Create/modify Workflow --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workflows](https://developers.cloudflare.com/api/resources/workflows) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create/modify Workflow PUT/accounts/{account\_id}/workflows/{workflow\_name} Creates a new workflow or updates an existing workflow definition. ##### 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 Scripts Write` ##### P ath ParametersExpand Collapse account\_id: string [Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) workflow\_name: string maxLength64 minLength1 [Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse class\_name: string maxLength255 minLength1 [Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20class_name%20%3E%20(schema)>) script\_name: string maxLength255 minLength1 [Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20script_name%20%3E%20(schema)>)

concurrency: optional object {limit }

limit: optional number Maximum number of instances of this workflow that can run concurrently. Additional instances are queued and started as running instances complete. Must not exceed the account concurrency limit. maximum9007199254740991 minimum1 Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20concurrency%20%3E%20(schema)>)

default\_retention: optional object {error\_retention, success\_retention } Default retention applied to instances of this version when they do not set their own retention.

error\_retention: optional numberor string Specifies the duration in milliseconds or as a string like ‘5 minutes’.

One of the following: number Specifies the duration in milliseconds. Link to this property string Link to this property

Link to this property

success\_retention: optional numberor string Specifies the duration in milliseconds or as a string like ‘5 minutes’.

One of the following: number Specifies the duration in milliseconds. Link to this property string Link to this property

Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20default_retention%20%3E%20(schema)>)

limits: optional object {steps }

steps: optional number maximum9007199254740991 minimum1 Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20limits%20%3E%20(schema)>)

schedules: optional array of object {cron }

cron: string maxLength256 minLength1 Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20schedules%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message }

code: number Link to this property message: string Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message }

code: number Link to this property message: string Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: object {id, class\_name, created\_on, 7 more }

id: string formatuuid Link to this property class\_name: string Link to this property created\_on: string formatdate-time Link to this property is\_deleted: number Link to this property modified\_on: string formatdate-time Link to this property name: string maxLength64 minLength1 Link to this property script\_name: string Link to this property terminator\_running: number Link to this property triggered\_on: string formatdate-time Link to this property version\_id: string formatuuid Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true [Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result\_info: optional object {count, per\_page, total\_count, 3 more }

count: number Link to this property per\_page: number Link to this property total\_count: number Link to this property cursor: optional string Link to this property page: optional number Link to this property total\_pages: optional number Link to this property

[Link to this property](<#(resource)%20workflows%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### Create/modify Workflow HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workflows/$WORKFLOW_NAME \ -X PUT \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "class_name": "x", "script_name": "x" }' ``` 200 example ``` { "errors": [], "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, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [], "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, "total_pages": 0 } } ```