v3

latestOpenAPI 3.0.0Proprietary2026-08-041323140.2 KB

API Endpoints

Get project details

Get a detailed project summary including all media files, compositions, and existing publishes.

Returns the project's id, name, drive_id, a map of media files (keyed by display path) with type and duration, a list of compositions with id, name, duration, and media type, and a list of successfully published share pages with their URLs, access levels, and publish times.

Use this to inspect a project's contents before editing or importing media, or to retrieve existing share URLs without triggering a republish.

get/projects/{project_id}

Path parameters

project_idstring uuid required

The project UUID

Response

Project details retrieved successfully

idstring uuid required

Project ID

namestring required

Project name

drive_idstring uuid required

Drive ID the project belongs to

created_atstring date-time required

When the project was created (ISO 8601)

updated_atstring date-time required

When the project was last updated (ISO 8601)

folder_pathstring

Full folder path for the project (e.g. "Clients/Acme/Videos"). Absent when the project is at the drive root.

media_filesobject required

Map of display path to media file info

Example response

{
  "folder_path": "Clients/Acme/Videos",
  "publishes": [
    {
      "share_url": "https://share.descript.com/view/abc123"
    }
  ]
}