Skip to main content
POST
Create a folder

Authorizations

Authorization
string
header
required

varg API key (varg_...). Get one at app.varg.ai or run bunx vargai login. App sessions may alternatively send a Supabase JWT.

Body

application/json
name
string
required
Required string length: 1 - 128
Example:

"Campaign assets"

slug
string

Lowercase alphanumeric words joined by single hyphens. Derived from the name (with a short random suffix) when omitted.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response

Folder created

workspace
object
required

A folder that groups files. Folders are shared with the dashboard, so a folder created through the API appears in the web app.