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

# PARTIAL-DELETE/Submission

> Esta API le permite eliminar selectivamente campos específicos de los datos de un envío individual. A diferencia de la eliminación completa, puede preservar los datos necesarios mientras elimina solo la información sensible, permitiendo un uso flexible según las políticas internas de su empresa.

<Warning>
  Notas Importantes

  * Los campos específicos eliminados no pueden ser restaurados.
  * Use esta API con precaución. Tenga cuidado de no eliminar accidentalmente datos importantes.
  * Cuando se aplica la Eliminación Parcial a un componente que es objetivo de verificación de duplicados, las verificaciones de duplicados no se aplicarán a ese envío.
    * Incluso si llegan datos idénticos al estado anterior a la aplicación de la Eliminación Parcial, las verificaciones de duplicados no se aplicarán.
</Warning>

## 1. Endpoint

```text PARTIAL-DELETE/Submission theme={null}
DELETE https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}
```

## 2. Autenticación

Incluya la clave API en el encabezado x-api-key:

```text x-api-key theme={null}
x-api-key: {yourAPIKey}
```

## 3. Parámetro de Solicitud

<ResponseField name="submission_id" type="string" required="true">
  ID único del envío a eliminar
</ResponseField>

<ResponseField name="fields" type="string" required="false">
  Use el parámetro fields para eliminar selectivamente tipos específicos de datos.
  Puede ingresar una de las siguientes opciones:

  * `id_image`
  * `selfie_image`
  * `data`: Conjunto de datos final confirmado como resultado del proceso
  * `OCR_raw`(\*sensible a mayúsculas): Conjunto de datos RAW extraído por OCR
  * `ocr`: Conjunto de datos convertido del OCR extraído a formato estandarizado
  * `review`: Conjunto de datos de resultado revisado por el usuario usando resultados OCR (procesado automáticamente con el mismo valor cuando la puntuación de reconocimiento OCR es alta)
  * `applicant_id`
  * `email`
  * `userid`
  * `additional_list`
  * `duplicated_information`
  * `custom_duplicated_information`
  * `injection_action`
</ResponseField>

<ResponseField name="data_fields" type="string">
  Use el parámetro data\_fields para eliminar selectivamente tipos específicos de información personal dentro del campo data. **`data_fields` solo funciona cuando el campo `data` está declarado en el parámetro `fields`**, y en este caso, si no se proporciona ningún valor en el parámetro data\_fields, todos los sub-datos bajo data serán eliminados.
  Data se refiere al conjunto de datos final confirmado como resultado del proceso.
  Puede ingresar una de las siguientes opciones:

  * `age_group`
  * `first_name`
  * `last_name`
  * `full_name` — se refiere al mismo campo que `name`
  * `full_name_en`
  * `name` — se refiere al mismo campo que `full_name`
  * `gender`
  * `nationality`
  * `date_of_birth`
  * `address_city`
  * `address_country`
  * `address_state`
  * `address_street`
  * `address_street2`
  * `address_zipcode`
  * `address_globalCode`
  * `address_compoundCode`
  * `address_formatted`
  * `address_input`
  * `address_detail`
  * `ip_address`
  * `idcard_issuingCountry`
  * `idcard_issueDate`
  * `idcard_expireDate`
  * `idType`
  * `documentNumber`
  * `identityNumber`
  * `ssnNumber`
  * `phoneNumber`
  * `cf1`
  * `cf2`
  * `cf3`

  <Note>
    `name` y `full_name` se refieren al mismo campo. Cualquiera de las dos claves se aplica a los mismos datos.
  </Note>
</ResponseField>

<ResponseField name="admin_name" type="string">
  Correo electrónico del administrador que realizó la eliminación
</ResponseField>

### 3-1. Datos a Eliminar

* Parámetros declarados en **fields** y **data\_fields**

### 3-2. Datos a Retener

* En los casos enviados, los parámetros no declarados en fields, y cuando se especifican parámetros específicos en data\_fields, los parámetros no especificados no serán eliminados y serán retenidos.

## 4. Ejemplo de Solicitud

### Usando solo fields

```curl PARTIAL-DELETE/Submission theme={null}
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}&fields=id_image' \ --header 'x-api-key: {yourAPIKey}'
```

### Usando fields y data\_fields

```curl PARTIAL-DELETE/Submission theme={null}
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}&fields=data&data_fields=gender,ip_address' \ --header 'x-api-key: {yourAPIKey}'
```

### Usando múltiples fields y data\_fields

```curl PARTIAL-DELETE/Submission theme={null}
curl --location --request DELETE 'https://rest-api.argosidentity.com/v3/submission/partial?submission_id={submission_id}&fields=id_image,data,selfie_image&data_fields=gender,ip_address' \ --header 'x-api-key: {yourAPIKey}'
```

## 5. Respuesta

### 5-1. Respuesta Exitosa

```result.json theme={null}
{
    "message": "success",
    "content": "Submission {submission_id} partially deleted successfully.",
    "statusCode": 200
}
```

### 5-2. Respuesta de Error

Si ocurre un error, se devuelve un código de estado 400 junto con detalles en el cuerpo de la respuesta:

```json error.json theme={null}
{
    "message": "submission_id is required",
    "statusCode": 400
}
```

### 5-3. Códigos de Error

| Error Code                                                                                                  | Descripción                                                                                                     |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `submission_id is required`                                                                                 | Falta el parámetro requerido `submission_id` en la solicitud                                                    |
| `fields parameter is required and cannot be empty`                                                          | Falta el parámetro requerido `fields` o está vacío en la solicitud                                              |
| `fields must be a string`<br />`data_fields must be a string`                                               | El parámetro `fields` no está en formato string<br /><br />El parámetro `data_fields` no está en formato string |
| `fields cannot be empty`                                                                                    | El parámetro `fields` está vacío                                                                                |
| `invalid fields found in fields: field1, field2`<br />`invalid fields found in data_fields: field1, field2` | Se incluyen campos inválidos en `fields`<br /><br />Se incluyen campos inválidos en `data_fields`               |
| `data_fields parameter is not allowed when fields does not include data`                                    | Se proporcionó el parámetro `data_fields` cuando `data` no está incluido en el parámetro `fields`               |
| `invalid format for fields: error message`                                                                  | El formato del parámetro `fields` es inválido                                                                   |
| `invalid format for data_fields: error message`                                                             | El formato del parámetro `data_fields` es inválido                                                              |
| `invalid API key for this project`                                                                          | La clave API proporcionada no es válida para este proyecto                                                      |
| `not Exist Submission Data`                                                                                 | No existen datos para el `submission_id` solicitado                                                             |
| `not Exist Project Data`                                                                                    | No existen datos del proyecto                                                                                   |
| `Internal server error`                                                                                     | Ocurrió un error interno del servidor                                                                           |
