Skip to main content
GET
List folders and courses

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Query Parameters

q
string

Only folders whose title contains this text (case-insensitive, 1-100 characters). Matched as plain text, so % and _ are not wildcards. Must not contain a NUL character (%00); one is rejected with VALIDATION_ERROR.

Required string length: 1 - 100
kind
enum<string>

Only folders (folder) or only courses (course).

Available options:
folder,
course
limit
integer
default:20

Page size, 1-100. Default 20; larger values are clamped to 100.

Required range: 1 <= x <= 100
parentId
string

Only folders directly inside this folder (a folder id), or root for top-level folders. Omit it to list all folders and courses, including nested ones.

cursor
string

The nextCursor of the previous page. Opaque; do not build or edit it. A cursor this API did not issue to you returns 400 INVALID_CURSOR (not retryable).

Maximum string length: 512

Response

One page of folders and courses.

data
object[]
required

The folders and courses on this page.

nextCursor
string | null
required

Pass as cursor to get the next page. null on the last page.