Saltar al contenido principal
DELETE
/
faces
Delete a face from collection
curl --request DELETE \
  --url https://face.argosidentity.com/faces \
  --header 'x-api-key: <api-key>'
{
  "message": "Face deleted successfully"
}
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

​
x-api-key
string
requerido
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.

​
Parámetros de Consulta

​
collectionId
string
requerido
El identificador único de la colección que contiene el rostro que desea eliminar.
​
faceId
string
requerido
El identificador único del envío de rostro que desea eliminar.

​
Respuesta

​
Respuesta Exitosa (200)

​
message
string
Un mensaje que indica el resultado exitoso o de error de la operación de eliminación.

​
Respuestas de Error

​
Bad Request (400)

​
errorCode
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
​
message
string
Describe brevemente el error. Consulte el código de error para más detalles.

​
Forbidden (403)

​
errorCode
string
Identifica el error específico para resolución de problemas:
  • 6039: API Key is required
  • 6040: Access Denied: API Key is unavailable
​
message
string
Describe brevemente el error. Consulte el código de error para más detalles.

Autorizaciones

​
x-api-key
string
header
requerido

Parámetros de consulta

​
collectionId
string
requerido

Unique identifier of the collection

​
faceId
string
requerido

Unique identifier of the face to delete

Respuesta

Face successfully deleted from collection

​
message
string

Success message

Ejemplo:

"Face deleted successfully"