<aside> ℹ️ Note: this document is subject to change and may be updated periodically as development and testing of the functionality progresses. Updates will be highlighted in the Changelog below this message.

Changelog

</aside>

This document outlines a proposed procedure to upload an audio file to the Voyc platform. There are 2 HTTP calls that need to be made in order to successfully upload audio.

<aside> ℹ️ Note: the below needs to happen for each audio file. We do not support bulk uploads.

</aside>

Steps:

  1. POST request to Voyc API to supply the conversation metadata and retrieve secure S3 upload token.
  2. Upload an audio file directly to S3

<aside> ⚠️ In the examples below <url> should be replaced with the base url specific to your organisation. Please contact Voyc support if you are unsure.

The base url can be seen from the login page. In https://app.voyc.ai/login the base url is api.app.voyc.ai.

</aside>

Step 1 - POST request to Voyc API

Endpoint: https://<url>/api/v2/workspace/{organisation_id}/conversation/upload_data/

Request Type: POSTAuthorization: Bearer Token (See ‘Generating an Authorization Token’ below)

Request Headers:

Content-type: application/json
Authorization: Bearer <token>

See below for token generation

Examples