--- title: Batch create new Workflow instances --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Workflows](https://developers.cloudflare.com/api/python/resources/workflows) [Instances](https://developers.cloudflare.com/api/python/resources/workflows/subresources/instances) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Batch create new Workflow instances workflows.instances.bulk(strworkflow\_name, InstanceBulkParams\*\*kwargs) -> SyncSinglePage\[[InstanceBulkResponse]()] POST/accounts/{account\_id}/workflows/{workflow\_name}/instances/batch Creates multiple workflow instances in a single batch operation. ##### 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` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20bulk%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) workflow\_name: str maxLength64 minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20bulk%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>)
body: Iterable\[Body] instance\_id: Optional\[str] The system reserves IDs that consist of the cf_ prefix and exactly 64 lowercase hexadecimal characters. maximum100 minimum1 Link to this property
instance\_retention: Optional\[BodyInstanceRetention]
error\_retention: Optional\[Union\[int, str]] Specifies the duration in milliseconds or as a string like ‘5 minutes’. One of the following: int Specifies the duration in milliseconds. Link to this property str Link to this property
Link to this property
success\_retention: Optional\[Union\[int, str]] Specifies the duration in milliseconds or as a string like ‘5 minutes’. One of the following: int Specifies the duration in milliseconds. Link to this property str Link to this property
Link to this property
Link to this property
location\_hint: Optional\[Literal\["wnam", "weur", "enam", 8 more]] One of the following: "wnam" Link to this property "weur" Link to this property "enam" Link to this property "eeur" Link to this property "apac" Link to this property "apac-ne" Link to this property "apac-se" Link to this property "oc" Link to this property "sam" Link to this property "afr" Link to this property "me" Link to this property
Link to this property params: Optional\[str] JSON-encoded event payload passed into the new instance. Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20bulk%20%3E%20(params)%20default%20%3E%20(param)%20body%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class InstanceBulkResponse: … id: str maxLength100 minLength1 Link to this property
status: Literal\["queued", "running", "paused", 6 more] One of the following: "queued" Link to this property "running" Link to this property "paused" Link to this property "errored" Link to this property "terminated" Link to this property "complete" Link to this property "waitingForPause" Link to this property "waiting" Link to this property "rollingBack" Link to this property
Link to this property version\_id: str formatuuid Link to this property workflow\_id: str formatuuid Link to this property
trigger\_source: Optional\[Literal\["unknown", "api", "binding", 2 more]] One of the following: "unknown" Link to this property "api" Link to this property "binding" Link to this property "event" Link to this property "cron" Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(model)%20instance_bulk_response%20%3E%20(schema)>) ### Batch create new Workflow instances Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.workflows.instances.bulk( workflow_name="x", account_id="account_id", body=[{}], ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": [ { "id": "x", "status": "queued", "version_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "trigger_source": "unknown" } ], "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": "x", "status": "queued", "version_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "workflow_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "trigger_source": "unknown" } ], "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ```