--- title: Batch create new Workflow instances --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Workflows](https://developers.cloudflare.com/api/go/resources/workflows) [Instances](https://developers.cloudflare.com/api/go/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 client.Workflows.Instances.Bulk(ctx, workflowName, params) (\*SinglePage\[[InstanceBulkResponse]()], error) 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 workflowName string 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)>)
params InstanceBulkParams AccountID param.Field\[string] Path param Link to this property
Body param.Field\[\[]InstanceBulkParamsBody] Body param InstanceID stringOptional The system reserves IDs that consist of the cf_ prefix and exactly 64 lowercase hexadecimal characters. maximum100 minimum1 Link to this property
InstanceRetention InstanceBulkParamsBodyInstanceRetentionOptional
ErrorRetention InstanceBulkParamsBodyInstanceRetentionErrorRetentionUnionOptional Specifies the duration in milliseconds or as a string like ‘5 minutes’. One of the following: UnionInt Link to this property UnionString Link to this property
Link to this property
SuccessRetention InstanceBulkParamsBodyInstanceRetentionSuccessRetentionUnionOptional Specifies the duration in milliseconds or as a string like ‘5 minutes’. One of the following: UnionInt Link to this property UnionString Link to this property
Link to this property
Link to this property
LocationHint InstanceBulkParamsBodyLocationHintOptional One of the following: const InstanceBulkParamsBodyLocationHintWnam InstanceBulkParamsBodyLocationHint = "wnam" Link to this property const InstanceBulkParamsBodyLocationHintWeur InstanceBulkParamsBodyLocationHint = "weur" Link to this property const InstanceBulkParamsBodyLocationHintEnam InstanceBulkParamsBodyLocationHint = "enam" Link to this property const InstanceBulkParamsBodyLocationHintEeur InstanceBulkParamsBodyLocationHint = "eeur" Link to this property const InstanceBulkParamsBodyLocationHintApac InstanceBulkParamsBodyLocationHint = "apac" Link to this property const InstanceBulkParamsBodyLocationHintApacNe InstanceBulkParamsBodyLocationHint = "apac-ne" Link to this property const InstanceBulkParamsBodyLocationHintApacSe InstanceBulkParamsBodyLocationHint = "apac-se" Link to this property const InstanceBulkParamsBodyLocationHintOc InstanceBulkParamsBodyLocationHint = "oc" Link to this property const InstanceBulkParamsBodyLocationHintSam InstanceBulkParamsBodyLocationHint = "sam" Link to this property const InstanceBulkParamsBodyLocationHintAfr InstanceBulkParamsBodyLocationHint = "afr" Link to this property const InstanceBulkParamsBodyLocationHintMe InstanceBulkParamsBodyLocationHint = "me" Link to this property
Link to this property Params stringOptional JSON-encoded event payload passed into the new instance. Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20bulk%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type InstanceBulkResponse struct{…} ID string maxLength100 minLength1 Link to this property
Status InstanceBulkResponseStatus One of the following: const InstanceBulkResponseStatusQueued InstanceBulkResponseStatus = "queued" Link to this property const InstanceBulkResponseStatusRunning InstanceBulkResponseStatus = "running" Link to this property const InstanceBulkResponseStatusPaused InstanceBulkResponseStatus = "paused" Link to this property const InstanceBulkResponseStatusErrored InstanceBulkResponseStatus = "errored" Link to this property const InstanceBulkResponseStatusTerminated InstanceBulkResponseStatus = "terminated" Link to this property const InstanceBulkResponseStatusComplete InstanceBulkResponseStatus = "complete" Link to this property const InstanceBulkResponseStatusWaitingForPause InstanceBulkResponseStatus = "waitingForPause" Link to this property const InstanceBulkResponseStatusWaiting InstanceBulkResponseStatus = "waiting" Link to this property const InstanceBulkResponseStatusRollingBack InstanceBulkResponseStatus = "rollingBack" Link to this property
Link to this property VersionID string formatuuid Link to this property WorkflowID string formatuuid Link to this property
TriggerSource InstanceBulkResponseTriggerSourceOptional One of the following: const InstanceBulkResponseTriggerSourceUnknown InstanceBulkResponseTriggerSource = "unknown" Link to this property const InstanceBulkResponseTriggerSourceAPI InstanceBulkResponseTriggerSource = "api" Link to this property const InstanceBulkResponseTriggerSourceBinding InstanceBulkResponseTriggerSource = "binding" Link to this property const InstanceBulkResponseTriggerSourceEvent InstanceBulkResponseTriggerSource = "event" Link to this property const InstanceBulkResponseTriggerSourceCron InstanceBulkResponseTriggerSource = "cron" Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(model)%20InstanceBulkResponse%20%3E%20(schema)>) ### Batch create new Workflow instances Go HTTPTypeScriptPythonGoTerraform ``` 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.Instances.Bulk( context.TODO(), "x", workflows.InstanceBulkParams{ AccountID: cloudflare.F("account_id"), Body: []workflows.InstanceBulkParamsBody{workflows.InstanceBulkParamsBody{ }}, }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```