> For the complete documentation index, see [llms.txt](https://bitel.gitbook.io/bitel/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitel.gitbook.io/bitel/files/upload-voice.md).

# Upload Voice

To use a custom voice in a call, the client has to first upload the file and retrieve the identifier. this identifier can then be used in call APIs

The file should be in binary format and the limit must be less than 128 megabytes.

<mark style="color:green;">`POST`</mark> `https://api.bitel.rest/api/v2/files/upload`

#### Headers

| Name         | Type   | Description        |
| ------------ | ------ | ------------------ |
| content-type | string | multipart/formdata |

#### Request Body

| Name | Type   | Description                     |
| ---- | ------ | ------------------------------- |
| data | object | the binary voice to be uploaded |

{% tabs %}
{% tab title="200 the result contains the voiceId" %}

```javascript
{
  "result": {
    "id": "9e8b2e5565774d3ebfa29082a7c61e6f",
    "dateCreated": 1564642810
  },
  "error": null
}
```

{% endtab %}
{% endtabs %}

The uploaded file can later be downloaded using the **voiceId**