Folders

Create a folder

Changed on

Creates a folder. It is the same object the dashboard shows. There is no delete endpoint; remove folders from the dashboard.

Fails with 422 workspace_owner_unresolvable when the account has no app user to own the folder (for example a service account).

post/workspaces

Request

  • Base URL: https://api.varg.ai/v2
  • URL: https://api.varg.ai/v2/workspaces
  • Auth: HTTP bearer

Request body

namestring required
slugstring

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

Example request

{
  "name": "Campaign assets"
}

Response

Folder created

Example response

{
  "workspace": {
    "name": "Campaign assets",
    "slug": "campaign-assets-3f9a1c2e"
  }
}

Changes