AssetFolders

Assets are files that can be stored in the system and referenced on products, variants, categories and global list values. Assets uploaded to the system are assigned a URL based on the assets file name. Each image asset can be auto-scaled, cropped and formatted by adding parameters to the URL of the asset. Thus, you should only upload an image once in the highest quality you will need it and the system will take care of any scaling automatically. Assets are organized in folders, which can be nested within each other.

Get an asset folder by its uid

get

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

folderUidstring · uuidRequired

Uid of folder

Responses

200

OK

application/json

Represents a folder in the mediabank

Uidstring · uuidOptional

Unique identifier of the folder

Namestring · nullableOptional

Name of the folder

ParentUidstring · uuid · nullableOptional

Unique identifier of the parent folder

IsPrivatebooleanOptional

Indicates whether files in this folder can only be accessed by authenticated users and not via public urls

ViewPermissionstring · uuid · nullableOptional

Unique identifier of permission required to view files in this folder

CreatePermissionstring · uuid · nullableOptional

Unique identifier of permission required to create files in this folder

DeletePermissionstring · uuid · nullableOptional

Unique identifier of permission required to Delete files in this folder

CreateBystring · nullableOptional

The user who created the folder

LastModifiedBystring · nullableOptional

The user who last modified the folder

Createdstring · date-timeOptional

The timestamp when the folder was created

LastModifiedstring · date-timeOptional

The timestamp when the folder was last modified

400

Bad Request

application/json

get

/v1/assetfolders/{folderUid}

HTTPcURLJavaScriptPython

GET /v1/assetfolders/{folderUid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "IsPrivate": true,
  "ViewPermission": "123e4567-e89b-12d3-a456-426614174000",
  "CreatePermission": "123e4567-e89b-12d3-a456-426614174000",
  "DeletePermission": "123e4567-e89b-12d3-a456-426614174000",
  "Path": [
    {
      "Uid": "123e4567-e89b-12d3-a456-426614174000",
      "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
      "Name": "text"
    }
  ],
  "CreateBy": "text",
  "LastModifiedBy": "text",
  "Created": "2026-02-26T05:35:48.684Z",
  "LastModified": "2026-02-26T05:35:48.684Z"
}

Delete an asset folder by its uid

delete

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

folderUidstring · uuidRequired

Uid of folder to delete

Responses

200

OK

No content

400

Bad Request

application/json

delete

/v1/assetfolders/{folderUid}

HTTPcURLJavaScriptPython

DELETE /v1/assetfolders/{folderUid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content

Get all child folders of a folder. Use empty Guid to get root folders (00000000-0000-0000-0000-000000000000).

get

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

folderUidstring · uuidRequired

Responses

200

OK

application/json

Represents a folder in the mediabank

Uidstring · uuidOptional

Unique identifier of the folder

Namestring · nullableOptional

Name of the folder

ParentUidstring · uuid · nullableOptional

Unique identifier of the parent folder

IsPrivatebooleanOptional

Indicates whether files in this folder can only be accessed by authenticated users and not via public urls

ViewPermissionstring · uuid · nullableOptional

Unique identifier of permission required to view files in this folder

CreatePermissionstring · uuid · nullableOptional

Unique identifier of permission required to create files in this folder

DeletePermissionstring · uuid · nullableOptional

Unique identifier of permission required to Delete files in this folder

CreateBystring · nullableOptional

The user who created the folder

LastModifiedBystring · nullableOptional

The user who last modified the folder

Createdstring · date-timeOptional

The timestamp when the folder was created

LastModifiedstring · date-timeOptional

The timestamp when the folder was last modified

400

Bad Request

application/json

get

/v1/assetfolders/{folderUid}/children

HTTPcURLJavaScriptPython

GET /v1/assetfolders/{folderUid}/children HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "Name": "text",
    "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
    "IsPrivate": true,
    "ViewPermission": "123e4567-e89b-12d3-a456-426614174000",
    "CreatePermission": "123e4567-e89b-12d3-a456-426614174000",
    "DeletePermission": "123e4567-e89b-12d3-a456-426614174000",
    "Path": [
      {
        "Uid": "123e4567-e89b-12d3-a456-426614174000",
        "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
        "Name": "text"
      }
    ],
    "CreateBy": "text",
    "LastModifiedBy": "text",
    "Created": "2026-02-26T05:35:48.684Z",
    "LastModified": "2026-02-26T05:35:48.684Z"
  }
]

Get a list of asset folders by their uids

post

Authorizations

ApiKey

AuthorizationstringRequired

Bodystring · uuid[]

application/json

string · uuid[]Optional

Responses

200

OK

application/json

Represents a folder in the mediabank

Uidstring · uuidOptional

Unique identifier of the folder

Namestring · nullableOptional

Name of the folder

ParentUidstring · uuid · nullableOptional

Unique identifier of the parent folder

IsPrivatebooleanOptional

Indicates whether files in this folder can only be accessed by authenticated users and not via public urls

ViewPermissionstring · uuid · nullableOptional

Unique identifier of permission required to view files in this folder

CreatePermissionstring · uuid · nullableOptional

Unique identifier of permission required to create files in this folder

DeletePermissionstring · uuid · nullableOptional

Unique identifier of permission required to Delete files in this folder

CreateBystring · nullableOptional

The user who created the folder

LastModifiedBystring · nullableOptional

The user who last modified the folder

Createdstring · date-timeOptional

The timestamp when the folder was created

LastModifiedstring · date-timeOptional

The timestamp when the folder was last modified

400

Bad Request

application/json

post

/v1/assetfolders/batch

HTTPcURLJavaScriptPython

POST /v1/assetfolders/batch HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 40

[
  "123e4567-e89b-12d3-a456-426614174000"
]

[
  {
    "Uid": "123e4567-e89b-12d3-a456-426614174000",
    "Name": "text",
    "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
    "IsPrivate": true,
    "ViewPermission": "123e4567-e89b-12d3-a456-426614174000",
    "CreatePermission": "123e4567-e89b-12d3-a456-426614174000",
    "DeletePermission": "123e4567-e89b-12d3-a456-426614174000",
    "Path": [
      {
        "Uid": "123e4567-e89b-12d3-a456-426614174000",
        "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
        "Name": "text"
      }
    ],
    "CreateBy": "text",
    "LastModifiedBy": "text",
    "Created": "2026-02-26T05:35:48.684Z",
    "LastModified": "2026-02-26T05:35:48.684Z"
  }
]

Create a new asset folder

post

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Folder information for creating a new folder

Uidstring · uuidOptional

Uid of the folder

Namestring · nullableOptional

Name of the folder

ParentUidstring · uuid · nullableOptional

Uid of the parent folder

IsPrivatebooleanOptional

Indicates whether files in this folder can only be accessed by authenticated users and not via public urls

ViewPermissionstring · uuid · nullableOptional

Uid of permission required to view files in this folder

CreatePermissionstring · uuid · nullableOptional

Uid of permission required to create files in this folder

DeletePermissionstring · uuid · nullableOptional

Uid of permission required to Delete files in this folder

Responses

200

OK

No content

400

Bad Request

application/json

post

/v1/assetfolders

HTTPcURLJavaScriptPython

POST /v1/assetfolders HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 300

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "IsPrivate": true,
  "ViewPermission": "123e4567-e89b-12d3-a456-426614174000",
  "CreatePermission": "123e4567-e89b-12d3-a456-426614174000",
  "DeletePermission": "123e4567-e89b-12d3-a456-426614174000"
}

No content

Update an existing asset folder

put

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Model for updating an existing folder

Uidstring · uuidOptional

Unique id of folder

Namestring · nullableOptional

Name of folder

ParentUidstring · uuid · nullableOptional

Unique id of parent folder

IsPrivatebooleanOptional

Indicates whether files in this folder can only be accessed by authenticated users and not via public urls

ViewPermissionstring · uuid · nullableOptional

Unique id of permission required to view files in this folder

CreatePermissionstring · uuid · nullableOptional

Unique id of permission required to create files in this folder

DeletePermissionstring · uuid · nullableOptional

Unique id of permission required to Delete files in this folder

Responses

200

OK

No content

400

Bad Request

application/json

put

/v1/assetfolders

HTTPcURLJavaScriptPython

PUT /v1/assetfolders HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 300

{
  "Uid": "123e4567-e89b-12d3-a456-426614174000",
  "Name": "text",
  "ParentUid": "123e4567-e89b-12d3-a456-426614174000",
  "IsPrivate": true,
  "ViewPermission": "123e4567-e89b-12d3-a456-426614174000",
  "CreatePermission": "123e4567-e89b-12d3-a456-426614174000",
  "DeletePermission": "123e4567-e89b-12d3-a456-426614174000"
}

No content