Skip to main content
POST
Create a Drive folder

Authorizations

Authorization
string
header
required

An API key from the web app (Settings → Developer), sent as Authorization: Bearer rvl_live_….

Body

application/json
name
string
required

Folder name.

Required string length: 1 - 255
parentId
string

Create it in this folder (dfld_… or sdfld_…). Leave out for the root.

driveId
string

A shared drive (drive_…, from GET /v1/drive/shared-drives). Leave out for your own Drive. Not needed with an sdfld_… folder.

Response

OK

id
string
required

dfile_… / dfld_… in a personal Drive, sdfile_… / sdfld_… in a shared drive. A file id works as a run input.

type
enum<string>
required
Available options:
folder,
file
name
string
required
driveId
string | null
required

The shared drive (drive_…) it is in; null in a personal Drive.

parentId
string | null
required

The folder it is in; null at the root.

format
string | null
required

Files: lowercase extension, e.g. sdf.

sizeBytes
number | null
required

Files: size in bytes.

mimeType
string | null
required
owner
object | null
required

Personal Drive: whose Drive it is in. Shared drive: who added it.

permission
enum<string>
required

Your access: in a personal Drive owner, admin, editor, commenter or viewer (from a share, inherited from a folder above, or a project); in a shared drive your role.

Available options:
owner,
admin,
editor,
commenter,
viewer,
manager,
contributor
canEdit
boolean
required

Whether you can rename, move or add to it.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required