Skip to main content
GET
List projects

Authorizations

Authorization
string
header
required

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

Query Parameters

name
string

Filter projects whose name contains this string (case-insensitive).

folder_path
string

Filter projects by folder path (e.g. "Clients/Acme/Videos"). Use "/" to separate nested folders. Returns only projects directly inside the deepest folder.

created_by
string

Filter projects created by this user UUID. Pass me to filter by the authenticated user.

created_after
string<date-time>

Filter projects created after this ISO 8601 timestamp.

created_before
string<date-time>

Filter projects created before this ISO 8601 timestamp.

updated_after
string<date-time>

Filter projects updated after this ISO 8601 timestamp.

updated_before
string<date-time>

Filter projects updated before this ISO 8601 timestamp.

sort
enum<string>
default:created_at

Sort field. Defaults to created_at.

Available options:
name,
created_at,
updated_at,
last_viewed_at
direction
enum<string>
default:desc

Sort direction. Defaults to desc.

Available options:
asc,
desc
cursor
string

Pagination cursor from a previous response's pagination.next_cursor.

limit
integer
default:20

Number of projects per page (1-100). Defaults to 20.

Required range: 1 <= x <= 100

Response

Projects listed successfully

data
object[]
required
pagination
object
required