**Source URL:** https://limited.veevavault.dev/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/replace-participant-on-all-active-workflows

# Replace Participant on All Active Workflows

Replace one user or group for another across every active workflow in which the current user or group is a member. This endpoint is a one-for-one swap: The current user is removed and the new user is added in each affected group. This is useful for reassigning tasks from one user or group to another.

This endpoint returns a `job_id`. You can then retrieve per-workflow outcomes with [Retrieve Replace Participant on All Active Workflows Results](/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/retrieve-replace-participant-on-all-active-workflows-results).

The new user or group must satisfy any role constraints on each affected group, or that workflow's replacement fails. If the new user is already a member of a group, that group's replacement operation reduces to removing the current user only, as the requested replacement user is already a participant in the workflow.

Replace updates participant-group membership only, it does not move or reassign in-progress work. A task already assigned to (or accepted by) the replaced-out user stays assigned to that user; it is not cancelled or transferred to the new participant. If the group has active tasks, the newly added participant receives a new task. To hand off an in-progress task to another user, use *Reassign Task*. Or, once a new task is assigned to your newly added participant, you can cancel the previous already-assigned task with *Cancel Task*. Initiate a reassign or cancel task with [Initiate Workflow Actions on Multiple Workflows](/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/initiate-workflow-actions-on-multiple-workflows).

<Endpoint path="/api/{version}/object/workflow/actions/replaceparticipant" method="POST" />

## Headers

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `application/json` |
| `Accept` | `application/json` |
</FieldTable>

## Body Parameters

<FieldTable>
| Name | Description |
| --- | --- |
| `current_user_id`<Requiredness type="conditional" /> | The Vault user ID to swap out. Supply exactly one of `current_user_id` or `current_group_id`. |
| `current_group_id`<Requiredness type="conditional" /> | The Vault user group ID to swap out. Supply exactly one of `current_user_id` or `current_group_id`. |
| `new_user_id`<Requiredness type="conditional" /> | The Vault user ID to swap in. Supply exactly one of `new_user_id` or `new_group_id`. |
| `new_group_id`<Requiredness type="conditional" /> | The Vault user group ID to swap in. Supply exactly one of `new_user_id` or `new_group_id`. |
</FieldTable>

## Request

<CodeExample title="">
```bash
curl -X POST -H "Authorization: {AUTH_VALUE}" \
  -H "Content-Type: application/json" \
https://myvault.veevavault.com/api/v26.3/object/workflow/actions/replaceparticipant \
  --data '{ "current_user_id": 2055, "new_user_id": 1090 }'
```
</CodeExample>

## Response

<CodeExample title="">
```json
{
  "responseStatus": "SUCCESS",
  "data": {
    "job_id": 93702,
    "url": "/api/v26.3/services/jobs/93702",
    "results_url": "/api/v26.3/object/workflow/actions/replaceparticipant/results/93702"
  }
}
```
</CodeExample>

## Response Details

On `SUCCESS`, Vault returns a `job_id`. You can poll the job status with [Retrieve Job Status](/qualityone/vault-api/api-reference/26.3/jobs/retrieve-job-status), and once complete, obtain results from [Retrieve Replace Participant on All Active Workflows Results](/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/retrieve-replace-participant-on-all-active-workflows-results).

---

**Previous:** [Remove Participant from All Active Workflows](/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/remove-participant-from-all-active-workflows)  
**Next:** [Retrieve Remove Participants from Multiple Workflows Results](/qualityone/vault-api/api-reference/26.3/workflows/bulk-active-workflow-actions/retrieve-remove-participants-from-multiple-workflows-results)