---
title: Instances
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/go)

[Workflows](https://developers.cloudflare.com/api/go/resources/workflows)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Instances

##### [List of workflow instances](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/list)

client.Workflows.Instances.List(ctx, workflowName, params) (\*V4PagePaginationArray\[[InstanceListResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances%20%3E%20(model)%20InstanceListResponse%20%3E%20(schema)>)], error)

GET/accounts/{account\_id}/workflows/{workflow\_name}/instances

##### [Get logs and status from instance](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/get)

client.Workflows.Instances.Get(ctx, workflowName, instanceID, params) (\*[InstanceGetResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances%20%3E%20(model)%20InstanceGetResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id}

##### [Create a new workflow instance](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/create)

client.Workflows.Instances.New(ctx, workflowName, params) (\*[InstanceNewResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances%20%3E%20(model)%20InstanceNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/workflows/{workflow\_name}/instances

##### [Batch create new Workflow instances](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/bulk)

client.Workflows.Instances.Bulk(ctx, workflowName, params) (\*SinglePage\[[InstanceBulkResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances%20%3E%20(model)%20InstanceBulkResponse%20%3E%20(schema)>)], error)

POST/accounts/{account\_id}/workflows/{workflow\_name}/instances/batch

##### [Get full step output from instance](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/methods/step)

client.Workflows.Instances.Step(ctx, workflowName, instanceID, params) (\*[InstanceStepResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances%20%3E%20(model)%20InstanceStepResponse%20%3E%20(schema)>), error)

GET/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id}/step

#### InstancesStatus

##### [Change status of instance](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/subresources/status/methods/edit)

client.Workflows.Instances.Status.Edit(ctx, workflowName, instanceID, params) (\*[InstanceStatusEditResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances.status%20%3E%20(model)%20InstanceStatusEditResponse%20%3E%20(schema)>), error)

PATCH/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id}/status

#### InstancesEvents

##### [Send event to instance](https://developers.cloudflare.com/api/go/resources/workflows/subresources/instances/subresources/events/methods/create)

client.Workflows.Instances.Events.New(ctx, workflowName, instanceID, eventType, params) (\*[InstanceEventNewResponse](<https://developers.cloudflare.com/api/go/resources/workflows#(resource)%20workflows.instances.events%20%3E%20(model)%20InstanceEventNewResponse%20%3E%20(schema)>), error)

POST/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id}/events/{event\_type}