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

# Data Lifecycle & Risk Evaluation

> Manage the creation and modification of customer data.

Granular control over how data is persisted (`action`) and how risk assessment logic is applied to that data (`sourceOfRiskLevel`) allows the API to serve multiple use cases, from historic data migration (where risk is already known) to live customer onboarding (where risk must be calculated in real-time).

## Request Control Parameters

The behavior of the endpoints is controlled by two key attributes in the request body.

| Attribute               | Description                                                                                                                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`action`**            | Determines the persistence strategy. <br />• `CREATE`: Creates a new record. Fails if the record exists.<br />• `UPDATE`: Modifies an existing record.                                                                         |
| **`sourceOfRiskLevel`** | Determines if the Risk Engine should trigger. <br />• `IMPORT`: Bypasses evaluation. Used when migrating data or manually overriding risk.<br />• `EVALUATE`: Triggers the Risk Engine to calculate risk based on the payload. |

## Lifecycle Matrix

The combination of `action` and `sourceOfRiskLevel` results in four distinct processing behaviors.

| Combination              | Behavior Description                                                                                                               | Typical Use Case                                                                                         |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **1. CREATE + IMPORT**   | **Direct Ingestion**<br />Creates a new record but skips the risk engine. The risk level provided in the payload is saved "as is". | • Data Migration<br />• System Restoration<br />• Importing pre-vetted archives                          |
| **2. CREATE + EVALUATE** | **New Assessment**<br />Creates a new record and immediately runs the risk engine to calculate and assign a risk level.            | • New Customer Onboarding<br />• First-time application processing                                       |
| **3. UPDATE + IMPORT**   | **Manual Override / Correction**<br />Updates existing attributes without re-triggering risk calculation.                          | • Fixing typos (e.g., name misspelling)<br />• Admin manual override of a risk score                     |
| **4. UPDATE + EVALUATE** | **Re-Assessment**<br />Updates attributes and re-runs the risk engine to determine if the changes affect the risk profile.         | • KYC Refresh (Periodic Review)<br />• Change in customer circumstances (e.g., new country of residence) |