Delete a face

Delete a face for good. A face still assigned to a template cannot be deleted — objects made from that template would be left with nothing to show. Point the template at another face first. Requires the `faces.delete` permission.

DELETE
/faces/{faceId}
AuthorizationBearer <token>

The access token returned after a successful sign-in, sent as Authorization: Bearer <access_token>.

It identifies the person and the organization they are working in, and it lasts about fifteen minutes. When it runs out, use their refresh token at POST /auth/refresh-token instead of asking them to sign in again.

In: header

Path Parameters

faceId*string

Identifier of the face.

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://api.dual.network/faces/665f1c2d4b1a2c3d4e5f6a50"
{}
{
  "code": 3,
  "message": "face is assigned to a template"
}

{
  "code": 16,
  "message": "no auth provided"
}

{
  "code": 13,
  "message": "internal error"
}