Designs

These endpoints are used to manage tenant public designs. They cover obvious set of CRUD operations with file, including folder and collection manipulations

Create

Creates new entity

Request
POST /api/storage/v1/designs[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
id formData

Desired unique design identifier for new design
metadata.fonts formData

Design font metadata list
metadata.surfaces formData

Design surface metadata list
metadata.hasDataSchema formData

Indicates whether design has data schema
metadata.dataSchemaId formData

Design data schema id. Empty string for embedded schema
metadata.dataSchemaName formData

Design data schema name
hasProblems formData

Indicates whether design has any problems preventing normal processing, e.g. missing font etc.
file formData

Entity file content
*path formData

Parent folder full path
*name formData

Entity name
customFields formData

Entity custom attributes
Responses
Status Code Type Description Samples
201 DesignDto

Success
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

GetAll

Gets all entities relevant to specified query parameters

Request
GET /api/storage/v1/designs[?dataSchemaId&fontPostScriptName&path&includeSubfolders&skip&take&sorting&search&customFields&tenantId]
Parameters
Name In Type Default Notes
dataSchemaId query

Associated data schema identifier filter
fontPostScriptName query

Design font postscript name filter
path query

Folder path filter parameter
includeSubfolders query

If set to 'true', query result will contain list of all entities in desired folder and subfolders
skip query

Defines page start offset from beginning of sorted result list
take query

Defines page length (how much consequent items of sorted result list should be taken)
sorting query

Defines sorting order of result list e.g.: "Title ASC, LastModified DESC"
search query

Search string for partial match
customFields query

Custom attributes dictionary filter {"public":"true","name":"my item"}
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 PagedOfDesignDto

Success
401

Unauthorized
403

Forbidden

Copy

Copies specified entity

Request
POST /api/storage/v1/designs/{id}[?path&name&strategy&tenantId]
Parameters
Name In Type Default Notes
*id path

Source entity identifier
path query

Desired path
name query

Desired name
strategy query

Conflict resolving strategy
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
201 DesignDto

Success
409 NameConflictDto

Conflict
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

Update

Updates specified entity

Request
PUT /api/storage/v1/designs/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Entity unique identifier
tenantId query

Tenant identifier
metadata.fonts formData

Design font metadata list
metadata.surfaces formData

Design surface metadata list
metadata.hasDataSchema formData

Indicates whether design has data schema
metadata.dataSchemaId formData

Design data schema id. Empty string for embedded schema
metadata.dataSchemaName formData

Design data schema name
hasProblems formData

Indicates whether design has any problems preventing normal processing, e.g. missing font etc.
file formData

Entity file content
path formData

Parent folder full path
name formData

Entity name
customFields formData

Entity custom attributes
Responses
Status Code Type Description Samples
200 DesignDto

Success
404 ProblemDetails

Not Found
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

Get

Gets entity by id

Request
GET /api/storage/v1/designs/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Entity unique identifier
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 DesignDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

Delete

Deletes specified entity

Request
DELETE /api/storage/v1/designs/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Entity unique identifier
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 DesignDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

GetFile

Gets entity file from file storage

Request
GET /api/storage/v1/designs/{id}/file[?attachment&tenantId]
Parameters
Name In Type Default Notes
*id path

Entity unique identifier
attachment query

If set to 'true', file will be provided as an attachment with proper filename supplied (default value is 'false')
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 string

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

AddPreview

Creates preview entity for specified source entity

If preview entity with specified namespace and name already exists it will be overwritten

Request
PUT /api/storage/v1/designs/{id}/preview[?tenantId]
Parameters
Name In Type Default Notes
*id path

Source entity unique identifier
tenantId query

Tenant identifier
*name formData

Preview name
*namespace formData

Preview namespace
*width formData

Preview image width
*height formData

Preview image height
format formData

Preview image format, e.g. Jpeg, Png, Bmp ...
file formData

Preview file content
Responses
Status Code Type Description Samples
200 DesignDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

BatchCopy

Copies selected entities and folders to another folder specified by path

Request
POST /api/storage/v1/designs/batchCopy[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
body body BatchCopyInput

Operation parameters
Responses
Status Code Type Description Samples
200

Success
409 BatchConflictDto

Conflict
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

BatchDelete

Deletes selected entities and folders

Request
POST /api/storage/v1/designs/batchDelete[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
body body BatchDeleteInput

Operation parameters
Responses
Status Code Type Description Samples
200

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

BatchUpdateParentFolder

Updates parent folder for selected entities and folders

Request
POST /api/storage/v1/designs/batchUpdateParentFolder[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
body body BatchUpdateParentFolderInput

Operation parameters
Responses
Status Code Type Description Samples
200

Success
409 BatchConflictDto

Conflict
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

GetAllCollections

Gets all collections

Request
GET /api/storage/v1/designs/collections[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 CollectionDto []

Success
401

Unauthorized
403

Forbidden

CreateCollection

Creates new collection

Request
POST /api/storage/v1/designs/collections[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
body body CreateCollectionDto

Create operation parameters
Responses
Status Code Type Description Samples
201 CollectionDto

Success
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

GetCollection

Gets collection content by collection id

Request
GET /api/storage/v1/designs/collections/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Collection unique identifier
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 CollectionContentOfDesignDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

UpdateCollection

Updates specified collection

Request
PUT /api/storage/v1/designs/collections/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Collection unique identifier
tenantId query

Tenant identifier
body body UpdateCollectionDto

Update operation parameters
Responses
Status Code Type Description Samples
200 CollectionDto

Success
404 ProblemDetails

Not Found
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

DeleteCollection

Deletes specified collection

Request
DELETE /api/storage/v1/designs/collections/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Collection unique identifier
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 CollectionDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

GetFolder

Gets folder content by folder path

Request
GET /api/storage/v1/designs/folders[?fullPath&tenantId]
Parameters
Name In Type Default Notes
fullPath query

Full folder path, if not set then root folder path is used
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 FolderContentOfDesignDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

CreateFolder

Creates new folder

Request
POST /api/storage/v1/designs/folders[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
body body CreateFolderDto

Create operation parameters
Responses
Status Code Type Description Samples
201 FolderDto

Success
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

DeleteFolder

Deletes specified folder

Request
DELETE /api/storage/v1/designs/folders[?fullPath&tenantId]
Parameters
Name In Type Default Notes
fullPath query

Folder full path
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 FolderDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

GetFolderInfo

Gets folder by id

Request
GET /api/storage/v1/designs/folders/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Folder unique identifier
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 FolderDto

Success
404 ProblemDetails

Not Found
401

Unauthorized
403

Forbidden

UpdateFolder

Updates specified folder

Request
PUT /api/storage/v1/designs/folders/{id}[?tenantId]
Parameters
Name In Type Default Notes
*id path

Folder unique identifier
tenantId query

Tenant identifier
body body UpdateFolderDto

Update operation parameters
Responses
Status Code Type Description Samples
200 FolderDto

Success
404 ProblemDetails

Not Found
409 NameConflictDto

Conflict
401

Unauthorized
403

Forbidden

GetAllFolders

Gets all folders

Request
GET /api/storage/v1/designs/folders/all[?tenantId]
Parameters
Name In Type Default Notes
tenantId query

Tenant identifier
Responses
Status Code Type Description Samples
200 FolderDto []

Success
401

Unauthorized
403

Forbidden

Definitions

DesignDto

Design dto class

Name Type Notes
metadata DesignMetadata[]

Design metadata
hasProblems boolean

Design 'hasProblems' tag indicates whether design has any problems preventing normal processing, e.g. missing font etc.
private boolean

Design 'private' tag indicates whether design is private
previews object

Preview dictionary Key: "previewMetadata.namespace-previewMetadata.name" Value: "previewMetadata"
size integer (int64)

Entity file size
folderId string

Parent folder id
tenantId integer (int32)

Entity tenant identifier
id string

Entity unique identifier
ownerId string

Entity owner identifier
name string

Entity name
customFields object

Entity custom attributes
lastModified string (date-time)

Last entity modification date and time

DesignMetadata

Design metadata

Name Type Notes
fonts DesignFontMetadata[]

Design font metadata list
surfaces DesignSurfaceMetadata[]

Design surface metadata list
hasDataSchema boolean

Indicates whether design has data schema
dataSchemaId string

Design data schema id. Empty string for embedded schema
dataSchemaName string

Design data schema name

DesignFontMetadata

Design font metadata list

Name Type Notes
postscriptName string

Font postscript name
family string

Font family name
style string

Font style

DesignSurfaceMetadata

Design surface metadata list

Name Type Notes
width number (float)

Design surface width
height number (float)

Design surface height

NameConflictDto

Information about operation subject which has name conflict

Name Type Notes
type ConflictType

Coflict type
id string

Operation subject identifier
name string

Operation subject name
path string

Operation subject folder path

ConflictType

Coflict type

Enum Values
Name
FolderOverwrite

PagedOfDesignDto

Paged list of items

Name Type Notes
total integer (int64)

Items count
items DesignDto[]

Items list

ProblemDetails

These endpoints are used to manage tenant public designs. They cover obvious set of CRUD operations with file, including folder and collection manipulations

Name Type Notes
type string
title string
status integer (int32)
detail string
instance string

BatchCopyInput

Operation parameters

Name Type Notes
path string

Folder path, describing folder to hold copies
entityIds array

List of entities, which are operation subjects
folderIds array

List of folders, which are operation subjects
conflictStrategy

Conflict resolving strategy, which should be applied if operation faces any conflict

BatchConflictDto

Information about batch operation subjects(folder and entities) which have name conflicts

Name Type Notes
entityConflicts ConflictDto[]

List of operation subject entity descriptions
folderConflicts ConflictDto[]

List of operation subject folder descriptions
type ConflictType

Coflict type

ConflictDto

List of operation subject entity descriptions

Name Type Notes
id string

Operation subject identifier
name string

Operation subject name
path string

Operation subject folder path

BatchDeleteInput

Operation parameters

Name Type Notes
entityIds array

List of entities, which are operation subjects
folderIds array

List of folders, which are operation subjects

BatchUpdateParentFolderInput

Operation parameters

Name Type Notes
path string

New parent folder path
entityIds array

List of entities, which are operation subjects
folderIds array

List of folders, which are operation subjects
conflictStrategy

Conflict resolving strategy

CollectionDto

These endpoints are used to manage tenant public designs. They cover obvious set of CRUD operations with file, including folder and collection manipulations

Name Type Notes
id string

Collection unique identifier
ownerId string

Entity owner identifier
name string

Entity name
customFields object

Entity custom attributes
lastModified string (date-time)

Last entity modification date and time

CreateCollectionDto

Create operation parameters

Name Type Notes
name string

Collection name

CollectionContentOfDesignDto

Collection content information

Name Type Notes
id string

Collection unique identifier
name string

Collection name
collections CollectionDto[]

List of contained collections
folders FolderDto[]

List of contained folders
entities DesignDto[]

List of contained entities

FolderDto

List of contained folders

Name Type Notes
id string

Folder unique identifier
path string

Parent folder full path
private boolean

Folder 'private' tag indicates whether folder is private
ownerId string

Entity owner identifier
name string

Entity name
customFields object

Entity custom attributes
lastModified string (date-time)

Last entity modification date and time

UpdateCollectionDto

Update operation parameters

Name Type Notes
name string

Collection name
entities array

Entity identifier list specifing entities, which are part of specified collection
folders array

Folder identifier list specifying folders, which are part of specified collection
collections array

Collection identifier list specifying collections, which are part of specified collection

FolderContentOfDesignDto

Folder content information

Name Type Notes
id string

Folder unique identifier
folders FolderInfoDto[]

List of contained subfolders
entities DesignDto[]

List of contained entities
entitiesCount integer (int64)

Count of all contained entities (including all subfolder entities)

FolderInfoDto

List of contained subfolders

Name Type Notes
hasChildren boolean

Folder 'has children' tag
id string

Folder unique identifier
path string

Parent folder full path
private boolean

Folder 'private' tag indicates whether folder is private
ownerId string

Entity owner identifier
name string

Entity name
customFields object

Entity custom attributes
lastModified string (date-time)

Last entity modification date and time

CreateFolderDto

Create operation parameters

Name Type Notes
name string

Folder name
path string

Parent folder path

UpdateFolderDto

Update operation parameters

Name Type Notes
name string

Folder name
path string

Parent folder path