> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Start process and copy data from another instance

> Start a new process whose initial data is copied from an existing process instance — useful for retry, resume, and clone-like workflows.

> [!TIP]
>
> Looking for end-to-end guidance on calling FlowX from your own app? See [Consuming FlowX from external apps](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/consuming-flowx-from-external-apps.md).

Start a new process instance and seed its data from a previously executed process instance. The new process picks up the data values that were on the source instance at the moment of the call.

Common use cases:

* Replaying a failed workflow with the same input
* Cloning an existing case for a similar customer
* Resuming downstream processing after an interruption

## Path parameters

**workspaceId** `string` *required*

The ID of the workspace that owns the application.

**appId** `string` *required*

The ID of the application.

**processName** `string` *required*

The name of the process definition to start.

**processInstanceId** `string` *required*

The UUID of the source process instance. Its data is copied into the new instance at start time.

## Request headers

**Authorization** `string` *required*

Bearer token. Format: `Bearer <token>`.

**Content-Type** `string` *required*

Must be `application/json`.

## Request body

A JSON object with values to merge on top of the copied data. Pass `{}` to start with the source instance's data unchanged.

```json theme={"dark"}
{
  "retryReason": "manual-rerun",
  "operatorId": "u-9023"
}
```

## Response

Same shape as [Start process by workspace, app, and process name](https://docs.flowx.ai/6.x/docs/api/start-process/start-by-process-name.md) — the new instance's `uuid`, `state`, and metadata.

```bash theme={"dark"}
curl -X POST "{BASE_URL}/api/runtime/wks/{workspaceId}/app/{appId}/process-name/{processName}/start/copyDataFrom/{processInstanceId}" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "retryReason": "manual-rerun"
  }'
```


## Related topics

- [Integration Designer](https://docs.flowx.ai/6.x/docs/platform-deep-dive/integrations/integration-designer.md)
- [FlowX.AI 5.6.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.6.0-march-2026/v5.6.0-march-2026.md)
- [Start subprocess action](https://docs.flowx.ai/6.x/docs/building-blocks/actions/start-subprocess-action.md)
- [Creating and managing process definitions](https://docs.flowx.ai/6.x/docs/flowx-designer/managing-a-project-flow/creating-a-new-process-definition.md)
- [Message Start Event](https://docs.flowx.ai/6.x/docs/building-blocks/node/message-events/message-catch-start-event.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.