> ## 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.

# DELETE/Faceauth

> Una API para eliminar de forma segura la imagen facial y los datos personales de un envío específico, conservando metadatos clave como auth_status y create_time.

<Note>
  * Solo se puede eliminar un envío por solicitud.
  * **Datos eliminados:** La imagen facial enviada y la información personal se eliminan permanentemente.
  * **Datos conservados:**
    * ID único del envío (`auth_id`)
    * Resultado de autenticación (`auth_status`)
    * Fecha y hora del envío (`createTime`)
</Note>

## 1. URL base

```text DELETE/FaceAuth theme={null}
https://rest-api.argosidentity.com/v3/faceauth
```

## 2. Autenticación

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

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

## 3. Ejemplo de solicitud

```curl DELETE/FaceAuth theme={null}
curl -X DELETE "https://rest-api.argosidentity.com/v3/faceauth?authId={yourAuthId}" \
-H "x-api-key: {yourAPIKey}" \
```

## 4. Parámetros de solicitud

<ResponseField name="authId" type="string">
  Se utiliza para especificar el envío único a eliminar.
</ResponseField>

<Note>
  * **Límite máximo de consulta**: Una única solicitud puede eliminar solo un envío.
  * **Obtención de datos adicionales**: Si existen más datos, la respuesta incluirá el objeto `nextPage_key`.
    Para continuar obteniendo datos, use el `authId` de `nextPage_key` como `nextKey_id` y `createTime` como `nextKey_date` en la siguiente solicitud.
</Note>

## 5. Respuesta

### 5-1. Respuesta (delete\_check: false)

```json result.json theme={null}
{
    "message": "success"
}
```

### 5-2. Datos de respuesta

<ResponseField name="faceAuth_projectId" type="string">
  ID del proyecto FaceAuth
</ResponseField>

### 6. Códigos 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}
{
    "errorCode": "required key is missing"
}
```

| Código de error                                    | Descripción                                       |
| -------------------------------------------------- | ------------------------------------------------- |
| `required key is missing`                          | Asegúrese de que la API-Key enviada sea correcta. |
| `error in processing data`                         | Ocurrió un error al obtener los datos del envío.  |
| `Cannot find submission. Please check input data.` | El envío especificado no existe.                  |
| `error in delete submission`                       | Ocurrió un error al intentar eliminar el envío.   |