Create Import URL
curl --request POST \
--url https://descriptapi.com/v1/edit_in_descript/schema \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"partner_drive_id": "aa3b2d8d-e5ca-41c2-8801-683328293fb9",
"project_schema": {
"schema_version": "1.0.0",
"files": [
{
"name": "Jane's studio recording",
"uri": "https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955",
"start_offset": {
"seconds": 10
}
}
],
"source_id": "06b3f5bb-68a2-468a-a5d9-df155c1e3588"
}
}
EOFimport requests
url = "https://descriptapi.com/v1/edit_in_descript/schema"
payload = {
"partner_drive_id": "aa3b2d8d-e5ca-41c2-8801-683328293fb9",
"project_schema": {
"schema_version": "1.0.0",
"files": [
{
"name": "Jane's studio recording",
"uri": "https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955",
"start_offset": { "seconds": 10 }
}
],
"source_id": "06b3f5bb-68a2-468a-a5d9-df155c1e3588"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
partner_drive_id: 'aa3b2d8d-e5ca-41c2-8801-683328293fb9',
project_schema: {
schema_version: '1.0.0',
files: [
{
name: 'Jane\'s studio recording',
uri: 'https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955',
start_offset: {seconds: 10}
}
],
source_id: '06b3f5bb-68a2-468a-a5d9-df155c1e3588'
}
})
};
fetch('https://descriptapi.com/v1/edit_in_descript/schema', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://descriptapi.com/v1/edit_in_descript/schema",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'partner_drive_id' => 'aa3b2d8d-e5ca-41c2-8801-683328293fb9',
'project_schema' => [
'schema_version' => '1.0.0',
'files' => [
[
'name' => 'Jane\'s studio recording',
'uri' => 'https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955',
'start_offset' => [
'seconds' => 10
]
]
],
'source_id' => '06b3f5bb-68a2-468a-a5d9-df155c1e3588'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://descriptapi.com/v1/edit_in_descript/schema"
payload := strings.NewReader("{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://descriptapi.com/v1/edit_in_descript/schema")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://descriptapi.com/v1/edit_in_descript/schema")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}"
response = http.request(request)
puts response.read_body{
"url": "https://web.descript.com/import?nonce=6e3625ca-f885-460d-b2e3-e3faac79c788"
}{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please try again later."
}Create Import URL
Create an Import URL by sending a Project schema to Descript API from your service’s backend.
Import Schema
Our import schemas are specified as a minimal JSON list of files which is detailed in full at the bottom of this section. At it’s smallest, the request body looks like:
{
"partner_drive_id": "162c61d1-6ced-4b25-a622-7dba922983ee",
"project_schema": {
"schema_version": "1.0.0",
"files": [{"uri": "https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955"}]
}
}
File Access
The file paths provided in the schema need to either be public or pre-signed URIs with enough time before expiration for failures and retries, we suggest URIs that won’t expire for 48 hours. We ask that the files have already been saved when the import link is generated to minimize cases where we’re waiting for eventually consistent storage of files that will never be written. We will, however, wait for eventual consistency of the storage layer and retry fetching files before eventually timing out.
Files must be hosted on preapproved hosts as our import process has an allow list which it checks URIs against.
Files will be requested with User-Agent: Descriptbot/1.0 (version may change) for tracking purposes.
Import link expiration
Import links are no longer valid after a user imports their data once. Viewing an already used import link will not allow for importing again and will not provide access to a previously created Descript Project. Partners are able to generate a new import link at any time, regardless of if a previous import link has been used.
The API does not currently provide partners with a link to the Descript Project, though users will be redirected to it from Descript’s web interface the first time they import files, and can always find the Project in Descript.
Import links expire after 3 hours and attempting to use an import link after the pre-signed links in the schema file have expired will result in an error, so we recommend generating the import link after the user has clicked the Edit in Descript button.
Supported media specification
We recommend sending the highest quality, uncompressed versions of files available to you. If you have multiple tracks, we recommend prioritizing sending us the full multi-track sequence over a combined file.
- Audio: WAV, FLAC, AAC, MP3
- Video: h264, HEVC (container: MOV, MP4)
POST
/
edit_in_descript
/
schema
Create Import URL
curl --request POST \
--url https://descriptapi.com/v1/edit_in_descript/schema \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"partner_drive_id": "aa3b2d8d-e5ca-41c2-8801-683328293fb9",
"project_schema": {
"schema_version": "1.0.0",
"files": [
{
"name": "Jane's studio recording",
"uri": "https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955",
"start_offset": {
"seconds": 10
}
}
],
"source_id": "06b3f5bb-68a2-468a-a5d9-df155c1e3588"
}
}
EOFimport requests
url = "https://descriptapi.com/v1/edit_in_descript/schema"
payload = {
"partner_drive_id": "aa3b2d8d-e5ca-41c2-8801-683328293fb9",
"project_schema": {
"schema_version": "1.0.0",
"files": [
{
"name": "Jane's studio recording",
"uri": "https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955",
"start_offset": { "seconds": 10 }
}
],
"source_id": "06b3f5bb-68a2-468a-a5d9-df155c1e3588"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
partner_drive_id: 'aa3b2d8d-e5ca-41c2-8801-683328293fb9',
project_schema: {
schema_version: '1.0.0',
files: [
{
name: 'Jane\'s studio recording',
uri: 'https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955',
start_offset: {seconds: 10}
}
],
source_id: '06b3f5bb-68a2-468a-a5d9-df155c1e3588'
}
})
};
fetch('https://descriptapi.com/v1/edit_in_descript/schema', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://descriptapi.com/v1/edit_in_descript/schema",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'partner_drive_id' => 'aa3b2d8d-e5ca-41c2-8801-683328293fb9',
'project_schema' => [
'schema_version' => '1.0.0',
'files' => [
[
'name' => 'Jane\'s studio recording',
'uri' => 'https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955',
'start_offset' => [
'seconds' => 10
]
]
],
'source_id' => '06b3f5bb-68a2-468a-a5d9-df155c1e3588'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://descriptapi.com/v1/edit_in_descript/schema"
payload := strings.NewReader("{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://descriptapi.com/v1/edit_in_descript/schema")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://descriptapi.com/v1/edit_in_descript/schema")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"partner_drive_id\": \"aa3b2d8d-e5ca-41c2-8801-683328293fb9\",\n \"project_schema\": {\n \"schema_version\": \"1.0.0\",\n \"files\": [\n {\n \"name\": \"Jane's studio recording\",\n \"uri\": \"https://descriptusercontent.com/jane.wav?signature=d182bca64bf94a1483d2fd16b579f955\",\n \"start_offset\": {\n \"seconds\": 10\n }\n }\n ],\n \"source_id\": \"06b3f5bb-68a2-468a-a5d9-df155c1e3588\"\n }\n}"
response = http.request(request)
puts response.read_body{
"url": "https://web.descript.com/import?nonce=6e3625ca-f885-460d-b2e3-e3faac79c788"
}{
"error": "rate_limit_exceeded",
"message": "Too many requests. Please try again later."
}Authorizations
Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.
Body
application/json
Edit in Descript schema POST body.
Response
Successful operation.
A url for partners to redirect their user to in order to start the import process—expires after 3 hours.
Example:
"https://web.descript.com/import?nonce=6e3625ca-f885-460d-b2e3-e3faac79c788"