> For the complete documentation index, see [llms.txt](https://api-old.innov8tif.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-old.innov8tif.com/okayface/face-search/face-insert.md).

# Face Insert

## Insert

<mark style="color:green;">`POST`</mark> `https://okaydocdemo.innov8tif.com/ekyc/api/innov-face/facequery/insert`

This API enables insertion of the facial image to database for query

#### Request Body

| Name        | Type   | Description                              |
| ----------- | ------ | ---------------------------------------- |
| apiKey      | string | To be assigned by Innov8tif              |
| imageBase64 | string | Selfie Image or Portrait Image in base64 |
| imageFile   | string | Selfie Image or Portrait Image           |
| groupName   | string | Group that exists in the database        |
| userName    | string | The person's name of the facial image    |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "groupName": "innov8tiftestnew",
    "groupStatus": "EXISTING",
    "name": "Jin-Xuan"
}
```

{% endtab %}
{% endtabs %}

### Input Example in Postman

![](/files/-MjTjGbcjUn-SN2ygt6S)

{% hint style="warning" %}
Insert facial image need to fulfill the [image requirement](https://api.innov8tif.com/okayface/image-requirements) for better accuracy
{% endhint %}

### Possible Responses

{% code title="When face is detected in the image and successful detected" %}

```
{
    "status": "success",
    "groupName": "Innov8tif_test_new",
    "groupStatus": "EXISTING",
    "name": "Jin-Xuan" 
}
```

{% endcode %}

{% code title="When no face is detected in image:" %}

```
{
    "status": "error",
    "message": "There is No Face Detected in Image" 
}
```

{% endcode %}