Descript API (1)

Download OpenAPI specification:Download

Access to the Overdub API is available only and exclusively to Descript Enterprise customers.


Descript API uses a personal token to authenticate your request. You can get your personal token by contacting us. The personal token should be used as a bearer token in the authorization header.

Authentication example

curl -H "authorization: Bearer ${YOUR_PERSONAL_TOKEN}"


Generate audio

In this part, we will generate our first audio with the Overdub API.

You will first need to find the id of the Voice with which to generate:

curl --request GET \
--url \
--header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}'

Once you pick your voice-id, generate an async task:

curl --request POST \
    --url \
    --header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}' \
    --header 'content-type: application/json' \
    --data '{
    "text": "Hey everyone, this is a generated audio",
    "voice_id": "${VOICE_ID}"
### Result {"id": "fc0a16f9-9bac-46f5-8917-ef9ea50531bb","state": "queued"}

Now fetch the result of the task (should be available after a few seconds):

curl --request GET \
    --url \
    --header 'authorization: Bearer ${YOUR_PERSONAL_TOKEN}'
### Result {"id": "fc0a16f9-9bac-46f5-8917-ef9ea50531bb","state": "done", "url":"https:url-to-audio.wav"}


Overdub API allows you to generate audio with your Descript Overdub Voice.

Generate a new Overdub.

It will create an Overdub generate async task. Use the get endpoint to fetch the job result. Usually, a task should take a few seconds. You can provide an optional callback_url as a parameter to this request. We will do a post to this url once the overdub is ready. There are two types of Overd