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

# Eliminar un rostro

> Elimine un rostro específico de una colección

Este endpoint de API le permite eliminar un rostro específico de una colección. Necesita proporcionar tanto el ID de la colección como el ID del rostro para eliminar exitosamente el rostro de la colección.

## Solicitud

### Headers

<ParamField header="x-api-key" type="string" required>
  La clave API utilizada para autenticación y control de acceso. Este parámetro de encabezado es requerido para autorización al eliminar un rostro de una colección.
</ParamField>

### Parámetros de Consulta

<ParamField header="collectionId" type="string" required>
  El identificador único de la colección que contiene el rostro que desea eliminar.
</ParamField>

<ParamField header="faceId" type="string" required>
  El identificador único del envío de rostro que desea eliminar.
</ParamField>

## Respuesta

### Respuesta Exitosa (200)

<ResponseField name="message" type="string">
  Un mensaje que indica el resultado exitoso o de error de la operación de eliminación.
</ResponseField>

### Respuestas de Error

#### Bad Request (400)

<ResponseField name="errorCode" type="string">
  Identifica el error específico para resolución de problemas:

  * 6010: CollectionId is required
  * 6011: WorkspaceId is required
  * 6012: Fail to add face
  * 6013: Cannot find collection info
  * 6014: This collection is unavailable
  * 6015: Failed to validate liveness of a face
  * 6016: Image Size is too large
  * 6017: Unsupported image format
</ResponseField>

<ResponseField name="message" type="string">
  Describe brevemente el error. Consulte el código de error para más detalles.
</ResponseField>

#### Forbidden (403)

<ResponseField name="errorCode" type="string">
  Identifica el error específico para resolución de problemas:

  * 6039: API Key is required
  * 6040: Access Denied: API Key is unavailable
</ResponseField>

<ResponseField name="message" type="string">
  Describe brevemente el error. Consulte el código de error para más detalles.
</ResponseField>


## OpenAPI

````yaml DELETE /faces
openapi: 3.1.0
info:
  title: Face ID API
  description: >-
    API for facial recognition and identity verification using Face ID
    technology
  version: 1.0.0
servers:
  - url: https://face.argosidentity.com
    description: Production server
security: []
paths:
  /faces:
    delete:
      tags:
        - Face ID
      summary: Delete a face from collection
      description: Remove a specific face from a collection
      operationId: deleteFace
      parameters:
        - name: collectionId
          in: query
          required: true
          schema:
            type: string
          description: Unique identifier of the collection
        - name: faceId
          in: query
          required: true
          schema:
            type: string
          description: Unique identifier of the face to delete
      responses:
        '200':
          description: Face successfully deleted from collection
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Success message
                    example: Face deleted successfully
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: number
                    description: Error code
                    enum:
                      - 6030
                      - 6031
                      - 6032
                      - 6033
                      - 6034
                  message:
                    type: string
                    description: Error message
        '403':
          description: Forbidden - Authentication required
          content:
            application/json:
              schema:
                type: object
                properties:
                  errorCode:
                    type: number
                    description: Error code
                    enum:
                      - 6039
                      - 6040
                  message:
                    type: string
                    description: Error message
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````