Skip to main content
POST
Import media to drive library

Authorizations

Authorization
string
header
required

Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.

Body

application/json
add_media
object
required

Map of media reference IDs to their import definitions. Key is the display name or path (e.g. "video.mp4" or "Folder/SubFolder/video.mp4"). Paths with forward slashes create nested folders automatically.

folder_id
string

Target drive media folder ID (UUID) or "root" for the root folder. If not provided, defaults to root.

callback_url
string<uri>

Optional callback URL to receive notifications about job status changes.

Response

Job created

job_id
string
required

The ID of the created import job. Use this to query job status.

drive_id
string
required

The drive ID where the media is being imported.

folder_id
string
required

The target folder ID in the drive media library.

drive_name
string | null

Human-readable name of the connected drive (workspace)

Example:

"My Team Workspace"

upload_urls
object

Signed upload URLs for direct upload media items. Only present when the request includes direct upload references.