FileResource

The following resources are part of this group:

/file/copy

Mount Point: /CNPortletapp/rest/file/copy

POST

Create a copy of the given file.

Request Body

element: fileCopyRequest

(no documentation provided)

Response Body

element: fileUploadResponse

(no documentation provided)

/file/create

Mount Point: /CNPortletapp/rest/file/create

POST

Create a new file handling multipart form-data. The data and meta data is encoded within separate body parts.

Request Body

element: (custom)

request with data for the file to be created

Response Body

element: fileUploadResponse

response containing the file meta data

/file/createSimple

Mount Point: /CNPortletapp/rest/file/createSimple

POST

Create a new file handling simple post data

Parameters

name description type default
folderId Folder ID where to save the file in query
databodypart (no documentation provided) query
qqfile (no documentation provided) query
description File description query

Request Body

element: (custom)

multipart/form-data request data

Response Body

element: fileUploadResponse

response containing the file meta data

POST

Create a new file handling simple post data

Parameters

name description type default
folderId Folder ID where to save the file in query
nodeId Node ID query 0
databodypart (no documentation provided) query
qqfile File name query
description File description query

Response Body

element: fileUploadResponse

response containing the file meta data

/file/localizationinfo

Mount Point: /CNPortletapp/rest/file/localizationinfo

GET

Get localization info for a list of files for a given channel and all master channels

Parameters

name description type default
id list of file ids query
nodeId id of the node to start with query

Response Body

element: localizationInfo

localization info

/file/push2master

Mount Point: /CNPortletapp/rest/file/push2master

POST

Push a list of pages from a channel into a master

Request Body

element: multiPushToMasterRequest

request

Response Body

element: genericResponse

generic response

/file/unlocalize

Mount Point: /CNPortletapp/rest/file/unlocalize

POST

Unlocalize files in a channel

Request Body

element: multiUnlocalizeRequest

request

Response Body

element: genericResponse

generic response

/file/load/{id}

Mount Point: /CNPortletapp/rest/file/load/{id}

GET

Load the file (without data)

Parameters

name description type default
id id of the file path
update true when the file is fetched for updating. Currently, files cannot be locked in the backend, but it is still recommended to set this parameter to true when the file shall be modified. query false
nodeId id of the node (channel) for which the image shall be loaded (when multichannelling is used). path

Response Body

element: fileLoadResponse

response containing the file

/file/localizationinfo/{id}

Mount Point: /CNPortletapp/rest/file/localizationinfo/{id}

GET

Get localization info for a file for a given channel and all master channels

Parameters

name description type default
id id of the file path
nodeId id of the node to start with query

Response Body

element: localizationInfo

localization info

/file/localize/{id}

Mount Point: /CNPortletapp/rest/file/localize/{id}

POST

Localize the given file

Parameters

name description type default
id id of the file to localize path

Request Body

element: localizeRequest

request

Response Body

element: genericResponse

generic response

/file/push2master/{id}

Mount Point: /CNPortletapp/rest/file/push2master/{id}

POST

Push a file from a channel into a master

Parameters

name description type default
id id of the file path

Request Body

element: pushToMasterRequest

request

Response Body

element: genericResponse

generic response

/file/save/{id}

Mount Point: /CNPortletapp/rest/file/save/{id}

POST

Save the given file

Parameters

name description type default
id (no documentation provided) path

Request Body

element: fileSaveRequest

request with the file to be saved

Response Body

element: genericResponse

generic response

POST

Save the posted content into the given file

Parameters

name description type default
id id of the file path

Request Body

element: (custom)

request with data for the file to be created

Response Body

element: genericResponse

generic response

/file/unlocalize/{id}

Mount Point: /CNPortletapp/rest/file/unlocalize/{id}

POST

Unlocalize the given file

Parameters

name description type default
id id of the file to unlocalize path

Request Body

element: unlocalizeRequest

request

Response Body

element: genericResponse

generic response

/file/usage/file

Mount Point: /CNPortletapp/rest/file/usage/file

GET

Get the files using one of the given files

Parameters

name description type default
skipCount number of items to be skipped, set to 0 for skipping no items query 0
maxItems maximum number of items to be returned, set to -1 for returning all items query -1
sortby (no documentation provided) query name
sortorder (no documentation provided) query asc
id list of file ids, for which the usage shall be fetched query
nodeId id of the node query
files true (default) if the files shall be returned, false for only returning the counts query true

Response Body

element: fileUsageListResponse

response

/file/usage/folder

Mount Point: /CNPortletapp/rest/file/usage/folder

GET

Get the folders using one of the given files

Parameters

name description type default
skipCount number of items to be skipped, set to 0 for skipping no items query 0
maxItems maximum number of items to be returned, set to -1 for returning all items query -1
sortby (no documentation provided) query name
sortorder (no documentation provided) query asc
id list of file ids, for which the usage shall be fetched query
nodeId id of the node query
folders true (default) if the folders shall be returned, false for only returning the counts query true

Response Body

element: folderUsageListResponse

response

/file/usage/image

Mount Point: /CNPortletapp/rest/file/usage/image

GET

Get the images using one of the given files

Parameters

name description type default
skipCount number of items to be skipped, set to 0 for skipping no items query 0
maxItems maximum number of items to be returned, set to -1 for returning all items query -1
sortby (no documentation provided) query name
sortorder (no documentation provided) query asc
id list of file ids, for which the usage shall be fetched query
nodeId id of the node query
files true (default) if the files shall be returned, false for only returning the counts query true

Response Body

element: fileUsageListResponse

response

/file/usage/page

Mount Point: /CNPortletapp/rest/file/usage/page

GET

Get the pages using one of the given files

Parameters

name description type default
skipCount number of items to be skipped, set to 0 for skipping no items query 0
maxItems maximum number of items to be returned, set to -1 for returning all items query -1
sortby (no documentation provided) query name
sortorder (no documentation provided) query asc
id list of file ids, for which the usage shall be fetched query
nodeId id of the node query
pages true (default) if the pages shall be returned, false for only returning the counts query true
template true for adding template info to the pages, default is false query false
folder true for adding folder info to the pages, default is false query false
langvars true for adding the language variants to the pages, default is false query false

Response Body

element: pageUsageListResponse

response

/file/usage/template

Mount Point: /CNPortletapp/rest/file/usage/template

GET

Get the templates using one of the given files

Parameters

name description type default
skipCount number of items to be skipped, set to 0 for skipping no items query 0
maxItems maximum number of items to be returned, set to -1 for returning all items query -1
sortby (no documentation provided) query name
sortorder (no documentation provided) query asc
id list of file ids, for which the usage shall be fetched query
nodeId id of the node query
templates true (default) if the templates shall be returned, false for only returning the counts query true

Response Body

element: templateUsageListResponse

response

/file/content/load/{id}

Mount Point: /CNPortletapp/rest/file/content/load/{id}

GET

Load the file with given id

Parameters

name description type default
id file id. This can either be the localid or a globalid path

Response Body

element: (custom)

response containing file binary data