POST v1/assets/folder

Use this endpoint to create a folder for your organization.

Request Information

URI Parameters

None.

Body Parameters

The folder information to be posted

FolderAssetModel
NameDescriptionTypeAdditional information
name

Folder Name, the maximum size of this field is 200 characters, and special characters are allowed.

 string

None.
parent

Only the root folder has no parent. When updating a folder, living this field empty will simply ignore it, but if the field is different than its original value, the folder will be moved to its new parent.

 string

None.
id

Folder unique identifier.

 string

None.
files

List of child files, note that this property can not be updated through the Folders API, Updates must be initiated using the files API

 Collection of FileAssetModel

None.
notes

Use this property to save notes for this folder. The amount of text associated is virtually unlimited, just remember that the more data, the heavier operations become.

 string

None.
tags

List of tags, currently only saving / retrieving tags are functional but tags are not included within searching functionality.

 Collection of string

None.
folders

Contains a list of sub folders, this property is read-only, operations on this property will not be saved when updating folders. User the regular API for folder update to update any sub folder in its own context.

 Collection of FolderAssetModel

None.
modified

date

None.

Request Formats

application/json, text/json

Sample: 
{
  "name": "sample string 1",
  "parent": "sample string 2",
  "id": "sample string 3",
  "files": [
    {
      "id": "sample string 1",
      "name": "sample string 2",
      "type": {
        "typeId": "sample string 1",
        "type": "sample string 3"
      },
      "tags": [
        "sample string 1",
        "sample string 2"
      ],
      "size": "sample string 4",
      "url": "sample string 5",
      "modified": "2025-06-26T07:53:56.6166531-07:00",
      "folder": "sample string 7",
      "notes": "sample string 9",
      "dimensions": "sample string 10"
    },
    {
      "id": "sample string 1",
      "name": "sample string 2",
      "type": {
        "typeId": "sample string 1",
        "type": "sample string 3"
      },
      "tags": [
        "sample string 1",
        "sample string 2"
      ],
      "size": "sample string 4",
      "url": "sample string 5",
      "modified": "2025-06-26T07:53:56.6166531-07:00",
      "folder": "sample string 7",
      "notes": "sample string 9",
      "dimensions": "sample string 10"
    }
  ],
  "notes": "sample string 4",
  "tags": [
    "sample string 1",
    "sample string 2"
  ],
  "folders": [],
  "modified": "2025-06-26T07:53:56.6166531-07:00"
}

Response Information

Resource Description

HttpResponseMessage
NameDescriptionTypeAdditional information
Version

Version

None.
Content

HttpContent

None.
StatusCode

HttpStatusCode

None.
ReasonPhrase

string

None.
Headers

Collection of Object

None.
RequestMessage

HttpRequestMessage

None.
IsSuccessStatusCode

boolean

None.