# Override process status 

{{<tags>}}

**Truora** provides a feature that allows you to modify the **final status** of a **completed process**. When necessary and under specific circumstances, you can manually approve or reject a final status decision, changing it from *Failure* to **Success** or *Success* to **Failure**.

You can only override the status of a **completed process**—processes in a **pending** status **cannot be modified**.

To enable this feature, your account must have the ``identity.processes.override.status`` permission. You must **Contact Truora** to request access and accept the associated **terms and conditions (T&C)**.

{{<notification message_top="**Truora** will not be responsible for any misuse of this feature." message_bottom=" " link=" " link_text=" ">}}

## How to change the final status of a process?

1. In the **Digital Identity** dashboard, go to **Results** and find the **process** you want to modify in the **Processes Results** panel.

{{<img src="/images/illustrations/override_status/find_override_process.gif" alt="Results in DI Sidebar" width="100%" class="border border-slate-300 rounded-md">}}

Once you select the process, a button labeled **Modify Status** will appear at the top.

{{<img src="/images/illustrations/override_status/modify_status_button.png" alt="Modify Status button" width="90%" class="border border-slate-300 rounded-md">}}

2. Click **Modify Status** to open the modal where you can enter the status override details.

{{<img src="/images/illustrations/override_status/override_modal.png" class="border border-slate-300 rounded-md" alt="Override process status modal" width="50%" class="border border-slate-300 rounded-md">}}

3. Fill in the **Required Information** and click **Modify Status** to confirm:

### Required Information

- **Reason**: The reason for changing the process status.
> The available reasons depend on whether the status is changing from **Failure → Success** or **Success → Failure**.

Here are the **Override Reasons** available for each case:

{{<table>}}
| Reason                            | Description                                                               | Applicable Override       |
|-----------------------------------|---------------------------------------------------------------------------|---------------------------|
|**Regular client**                 | Refers to the fact that the client is known.                              | Failure → **Success**     | 
|**In person customer**             | The customer's identity could be verified in person.                      | Failure → **Success**     |
|**Client meets all requirements**  | The client meets all requirements for the identity verification process   | Failure → **Success**     |
|**Manipulated document**           | Signs of manipulation detected in the client's document.                  | Success → **Failure**     |
|**Manipulated photo**              | The client's photo appears to be manipulated.                             | Success → **Failure**     |
|**Internal reasons**               | Status changed due to internal company policies.                          | Success → **Failure**     | 
|**Other**                          | A reason not listed above.                                                | **Both**                  |
{{</table>}}

- **Description**: A free-text area to provide additional details about the modification.  
- **Load file**: Optionally, upload supporting evidence.
- **Accept T&C checkbox**: You must accept the **T&C**, confirming that **Truora** is not liable for any consequences of the status change.

Once the change is confirmed, an **email notification** will be sent to the **account administrator**, including details about the modified process and the person responsible for the update.

## How to identify modified processes?

### In the results history list

Modified processes are easily identifiable in the Results History list. A **flag** will appear in the **State** column next to the process status. Hovering over the flag will display the message: "**This status has been modified**".

{{<img src="/images/illustrations/override_status/overridden_in_results_history.gif" alt="Overridden process in results history" width="100%" class="border border-slate-300 rounded-md">}}

### In the process results

When viewing a specific process, you can identify modifications through the following:

1. **Flag indicator** - A **flag** next to the **State** indicating that the process status has been modified.
2. **Modification details** - Information about the most recent modification, including:
    - ***Status Modification Date***
    - ***Reason***
    - ***Modified by***
    - ***Description***
    - ***Modification history***

{{<img src="/images/illustrations/override_status/overridden_process_details.png" alt="Overridden process details" width="95%" class="border border-slate-300 rounded-md">}}

3. **Modification history**: Displays a record of all modifications, as the final status of a process can be modified multiple times. Expanding the history shows details such as: 
    - ***Current Status***
    - ***Previous status***
    - ***Modification date***
    - ***Modification made by***
    - ***Reason*** 
    - ***IP***
    - ***Description***

{{<img src="/images/illustrations/override_status/overridden_process_history.png" alt="Overridden process history details" width="95%" class="border border-slate-300 rounded-md">}}


## Webhook Events for Status Overrides

When a process status is modified, two **webhook events** are available:

{{<table>}}
| Event                     | Description                                                        |
|---------------------------|--------------------------------------------------------------------|
|**Overwritten Failure**    | When a process status is changed from **Success** to **Failure**.  |
|**Overwritten Success**    | When a process status is changed from **Failure** to **Success**.  |
{{</table>}}

These events allow you to configure automated actions based on the status change.

- See the {{< newtab href="/guides/webhook_events_and_variables/" >}}Webhooks: Events and Variables{{< /newtab >}} guide to learn more about Truora's **events** and their associated **variables**.
- See the {{< newtab href="/guides/webhook_rule/" >}}Webhooks Rules{{< /newtab >}} guide to learn how to configure an **event** to trigger automated **actions**.