> ## 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 a face

> Remove a specific face from a collection

This API endpoint allows you to delete a specific face from a collection. You need to provide both the collection ID and the face ID to successfully remove the face from the collection.

## Request

### Headers

<ParamField header="x-api-key" type="string" required>
  The API key used for authentication and access control. This header parameter is required for authorization to delete a face from a collection.
</ParamField>

### Query Parameters

<ParamField header="collectionId" type="string" required>
  The unique identifier of the collection that contains the face you wish to delete.
</ParamField>

<ParamField header="faceId" type="string" required>
  The unique identifier of the face submission that you want to remove.
</ParamField>

## Response

### Success Response (200)

<ResponseField name="message" type="string">
  A message indicating the success or error result of the deletion operation.
</ResponseField>

### Error Responses

#### Bad Request (400)

<ResponseField name="errorCode" type="string">
  Identifies the specific error for troubleshooting:

  * 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">
  Briefly describes the error. Please refer to the error code for details.
</ResponseField>

#### Forbidden (403)

<ResponseField name="errorCode" type="string">
  Identifies the specific error for troubleshooting:

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

<ResponseField name="message" type="string">
  Briefly describes the error. Please refer to the error code for details.
</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

````