Skip to main content
GET
Search a drive

Authorizations

Authorization
string
header
required

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

Query Parameters

query
string
required

Search term. Matched against names and contents. Must be non-empty.

Minimum string length: 1
updated_after
string<date-time>

Return results updated at or after this time. Accepts an ISO 8601 date (2026-08-01, interpreted as the start of that UTC day) or timestamp (2026-08-01T09:30:00Z). Values without a timezone offset are read as UTC.

updated_before
string<date-time>

Return results updated at or before this time. Accepts an ISO 8601 date (2026-08-01, interpreted as the end of that UTC day) or timestamp (2026-08-01T23:59:59Z). Values without a timezone offset are read as UTC.

owner
string<uuid>[]

Return items owned by these user UUIDs. Repeat this parameter to include more than one owner. If omitted, results from all owners are returned.

type
enum<string>[]

Result types to search. Repeat this parameter to search more than one type. If omitted, all result types are returned.

  • project: Projects
  • layout_pack: Layout packs
  • project_folder: Folders that hold projects
  • media_library_folder: Folders in the drive media library
  • video, image, audio: Files of that media type in the drive media library, Brand Studio, and inside projects
Available options:
project,
video,
image,
audio,
project_folder,
media_library_folder,
layout_pack
match
enum<string>[]

How the query may match. Repeat this parameter to allow more than one kind. name matches project, file, folder, and layout pack names. content matches transcripts and composition text. If omitted, names and contents both contribute.

Available options:
name,
content
sort
enum<string>
default:relevance

How to sort results:

  • relevance: closest matches first. This is the default.
  • newest: most recently modified first.
  • oldest: least recently modified first.
Available options:
relevance,
newest,
oldest
limit
integer
default:30

Maximum number of results to return. Defaults to 30. Maximum is 100.

Required range: 1 <= x <= 100

Response

Search completed successfully.

Ranked search results.

results
(Project search result · object | Media search result · object | Layout pack search result · object | Project folder search result · object | Media library folder search result · object)[]
required

Search results ranked by relevance, best match first.

A project matched.