POST
/
v1
/
diarize

This endpoint allows you to create a new diarization from a remote audio URL.

​
Diarize a Remote File (from url)

If you have a media file accessible via a URL, you can provide the URL to the file in the request body with the header Content-Type set to application/json.

Typically you would use this method if you have a file stored in a cloud storage service such as Amazon S3.

Make sure the URL to the file is publicly accessible, otherwise our endpoint cannot read the file

​
Receiving the segments (Webhook)

The webhook URL is where the finished diarization segments will be sent. The segments will be sent as a JSON object in the request body.

Make sure the webhook URL is publicly accessible, otherwise our server cannot send the output

Please visit the Webhook documentation for more information on what the webhook sends.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string
required

URL of the audio file, must be publicly accessible

webhook
string
required

URL to send the result to

Response

200 - application/json
jobId
string

Job ID to track the progress of the diarization

message
string

Message about the job

status
string

Status of the job

Test Endpoint (+ webhook)Create Voiceprint