Create folder

Create a new folder in a workspace.

POST /folders

cURL

cURL

curl -X POST https://app.mavera.io/api/v1/folders \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Assets",
    "workspace_id": "ws_abc123"
  }'

201

{
  "id": "<string>",
  "object": "folder",
  "name": "<string>",
  "workspace_id": "<string>",
  "file_count": 123,
  "is_shared": true,
  "is_favorite": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json

name · string · required

Folder name

workspace_id · string · required

Workspace to create the folder in

Response

201

application/json

Folder created successfully

A folder for organizing files

id · string

Unique folder identifier

object · enum<string>

Available options: folder

name · string

Folder name

workspace_id · string

Workspace ID

file_count · integer

Number of files in the folder

is_shared · boolean

Whether the folder is shared with all workspace members

is_favorite · boolean

Whether the folder is in your favorites

created_at · string<date-time>

updated_at · string<date-time>