Version 1
Connector Overview: This page documents all 230 actions for the Otmmconnector V6 v1.
Assets (28)
POST Add Or Update Renditions of an Asset
/v6/assets/{id}/contents
Add Or Update Renditions of an Asset. Supported Rendtion types are Thumbnail or Preview. The content image supported as a multipart/form-data format. If the rendition sent other than png file, the file name with extension must be set to FormDataBodyPart.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The rendition type |
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
N/A |
POST Create Assets
/v6/assets
Create Asset(s) with the specified asset representation or import template. This should be a multipart/form-data request. Please use the utf-8 charset encoding so that any unicode characters in names of the attached files are interpreted properly. The operation creates a job and returns the job handle. Using the job id in job handle, you can query the 'jobs' resource for completion status.If only an asset representation is specified the user is required to have Apply/Remove Security Policy permission for all security policies assigned. If only an import template is specified the user is not required to have Apply/Remove Security Policy permission for the security policies inherited from the import template. If both an asset representation and an import template are specified the metadata, security policies, and categories populated into the assets will be determined by the asset representation, but the user will only be required to have Apply/Remove Security Policy permission for the security policies not present in the import template.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (11)
|
Option Name |
Description |
|---|---|
|
|
Id of the import template to use |
|
|
The parent folder id |
|
|
The review job id |
|
|
The review job task id |
|
|
The id of the job from where import is initiated. |
|
|
The id of the task from where import is initiated. |
|
|
Optional flag that indicates whether this asset has content or not. Set to true if the asset is not associated with content and false if associated with content. If set to true then any attached files and upload manifest will be ignored. |
|
|
N/A |
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
Name of the job to be triggered on the server. If this parameter is not set, the default value will be picked from settings. This parameter has highest precedence while deciding the job to trigger. |
|
|
Callback URL in the encoded form, which needs to be notified once the job is complete. For more information on the format of callbackURl , refer to integration guide. |
POST Create one or more links between assets.
/v6/assets/links
Create one or more links between assets.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Comma separated list of source asset ids |
POST Duplicate the given asset/folder.
/v6/assets/{id}/duplicate
Duplicate the given asset/folder to the destination folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
Destination folder id to move, copy or duplicate assets |
|
|
Method used to determine the position of the new children in the Folder |
|
|
If position_type is absolute the numeric position where the new children should be inserted into the existing children. If not specified the new children will be position after all existing children. If position_type is relative then you must specify either before or after to determine where the new children are inserted relative to the existing child identified by the relative_asset_id parameter. |
|
|
If position_type is relative then this parameter must be set to the asset id of the existing child relative to which new children should be added or moved. If position_type is absolute this parameter is ignored |
|
|
Depth to traverse when duplicating containers. Less than zero means traverse all the way down. |
POST Duplicate the given set of assets.
/v6/assets/duplicate
Duplicate assets based on the selection context to the given destination folder.
For duplicating the hierarchy of folders, use the depth parameter. Using selection context to expand will flatten out the asset structure and duplicate it.
Using selection context parameter to duplicate hierarchy of asset will result in validation error.While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
Destination folder id to move, copy or duplicate assets |
|
|
Method used to determine the position of the new children in the Folder |
|
|
If position_type is absolute the numeric position where the new children should be inserted into the existing children. If not specified the new children will be position after all existing children. If position_type is relative then you must specify either before or after to determine where the new children are inserted relative to the existing child identified by the relative_asset_id parameter. |
|
|
If position_type is relative then this parameter must be set to the asset id of the existing child relative to which new children should be added or moved. If position_type is absolute this parameter is ignored |
|
|
Depth to traverse when duplicating containers. Less than zero means traverse all the way down. |
PUT Lock or unlock or check-out or cancel check-out or delete or un-delete of an asset
/v6/assets/state
Lock or unlock or check-out or cancel check-out or delete or un-delete of an assetWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Asset 'state change' action; allowed values are check_out, cancel_check_out, lock, unlock, delete, un_delete |
PUT Lock or unlock or check-out or cancel check-out or delete or un-delete of an asset
/v6/assets/{id}/state
Lock or unlock or check-out or cancel check-out or delete or un-delete of an asset
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Asset 'state change' action; allowed values are check_out, cancel_check_out, lock, unlock, delete, un_delete |
PUT Remove list of specified parents for Asset Id.
/v6/assets/{id}/parents
Remove parents which are mentioned in comma separated parentIds string for current asset resource.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Type of operation. |
|
|
Comma separated list of the parent's ids to be detached |
DELETE Remove the links between assets
/v6/assets/links
Remove the links between assets
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Delete links parameter holding information about mode of removing the links between the assets and assetIds.AssetIds specified must be source of given links |
|
|
N/A |
GET Retrieve all orphan assets
/v6/assets/nofolders
Retrieve all orphan assets.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
N/A |
GET Retrieve all orphan assets sort options
/v6/assets/nofolders/sortoptions
Retrieves all sort options to sortorphan assets of the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all recent Asset
/v6/assets/recent
Retrieve all recently accessed assets of the logged in user.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
N/A |
GET Retrieve all recent assets sort options
/v6/assets/recent/sortoptions
Retrieves all sort options to sort recently accessed assets of the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all versions of an Asset
/v6/assets/{id}/versions
Retrieve all versions of the specified Asset.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
GET Retrieve an Asset
/v6/assets/{id}
Retrieve an Asset by asset id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Map of asset id and container path to expand. The given path will be expanded to have children of path elements. |
|
|
A comma separated list of Collection Ids |
|
|
N/A |
GET Retrieve assets based on the provided selection context.
/v6/assets
Retrieve assets based on the provided selection context. The request needs the pagination parameters to be passed. The asset collection will also include summary about the collection. To load only collection summary pass limit as 0.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
The selection context for the assets. |
|
|
Map of asset id and container path to expand. The given path will be expanded to have children of path elements. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
N/A |
GET Retrieve related assets of an asset
/v6/assets/{id}/relatedassets
Retrieve related assets of an asset.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
List of asset relations to retrieve assets |
|
|
N/A |
GET Retrieve spin360 content of an Asset
/v6/assets/{id}/contents/spin360
Retrieve spin360 content of an Asset by asset id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
N/A |
GET Retrieve the collections associated for the given asset id.
/v6/assets/{id}/collections
Retrieve the collections associated for the given asset id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
GET Retrieve the content or a rendition of an Asset
/v6/assets/{id}/contents
Retrieve the content or a rendition for the specified Asset. If no rendition_type parameter is specified the content of the asset will be returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Collection Id |
|
|
The rendition type |
|
|
The disposition type |
|
|
Is caching enabled for this request |
|
|
User-Agent HTTP header |
|
|
N/A |
GET Retrieve the latest version of an Asset
/v6/assets/{original_asset_id}/latestversion
Retrieve the latest version of an Asset by original asset id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The Original Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
GET Retrieve the parents for given asset id.
/v6/assets/{id}/parents
Retrieve the parents for given asset id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
PATCH Update an Asset
/v6/assets
Update metadata and/or reassign applicable security policies and/or associated categories for the specified Asset.
For metadata fields, only the type, id and value need to be specified.The asset must be locked by the user who is performing the edit operation.If the value for lockStrategy parameter passed is optimistic, then the user doesn't need to lock the asset prior to calling.The API will obtain the lock internally and perform the asset update
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
PATCH Update an Asset
/v6/assets/{id}
Update metadata and/or reassign applicable security policies and/or associated categories for the specified Asset.
For metadata fields, only the type, id and value need to be specified.The asset must be locked by the user who is performing the edit operation.If the value for lockStrategy parameter passed is optimistic, then the user doesn't need to lock the asset prior to calling.The API will obtain the lock internally and perform the asset update
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Lock Strategy: allowed values are optimistic,default. |
|
|
N/A |
POST subscribe of an asset
/v6/assets/{id}/subscriptions
subscribe of an asset
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST subscribe of assets
/v6/assets/subscriptions
subscribe of assetsWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Maximum number of items to retrieve. |
DELETE un-subscribe of an asset
/v6/assets/{id}/subscriptions
un-subscribe of an asset
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
DELETE un-subscribe of assets
/v6/assets/subscriptions
un-subscribe of assetsWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The selection context for the assets. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
Auditactivity (4)
GET Retrieve all audit tab event filter options
/v6/auditactivity/eventfilter/{assetType}
Retrieve all audit tab event filter options based on asset type to populate the filter.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Accepted value is "container" or "asset" |
|
|
N/A |
GET Retrieve all audit tab sort options
/v6/auditactivity/sortoptions
Retrieve all sort options to sort audited events for assets or containers.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve audited events for given asset id
/v6/auditactivity/{assetId}/activityhistory
Retrieve audited events for the selected asset.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Event Ids, comma delimited, If not specified, will retrieve based on System Settings. |
|
|
N/A |
|
|
Date Range for retrieveing events by audited date. |
|
|
Accepted value is "container" or "asset" |
|
|
Field to sort audited events. Prefix with asc_ or desc_ to specify the order |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve.If limit is not specified, the default limit will be 25. |
|
|
N/A |
GET Retrieve event details for event with given sequence id
/v6/auditactivity/{sequenceId}/details
Retrieve event details for event with given sequence id. Event details are only available for events whose extended_msg_data property is true.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Brandings (2)
GET Retrieve all or user specific brandings depends upon apply_user_filter flag
/v6/brandings
Retrieve list of branings for logged in user (from session) if apply_user_filter is not set or true(default is true) and it retrieves all brandings in the system if apply_user_filter is set as false.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Apply user filter |
|
|
Loads branding content information |
|
|
N/A |
GET Retrieve branding
/v6/brandings/{id}
Retrieve branding by branding id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Branding Id |
|
|
Loads branding content information |
|
|
N/A |
Cascadinggroups (2)
GET Retrieve a Cascading Group
/v6/cascadinggroups/{id}
Retrieve a Cascading Group by cascading group id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Cascading Group Id |
|
|
Load cascading domain values. |
|
|
N/A |
GET Retrieve the cascading lookup values for a level based on the values provided for previous levels
/v6/cascadinggroups/{id}/lookupvalues
Retrieve the cascading lookup values for a level based on the values provided for previous levels. The value(s) need to be passed as query parameter(s) named as "path" in the same order they were populated.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Cascading Group Id |
|
|
List of selected parent cascading domain value(s) as query parameter(s). The values should appear in the same order as they are populated in cascading domain. |
|
|
String for filtering cascading lookup values. If this parameter is provided, it returns only those cascading lookup values whose display field value starts with the value provided for this parameter and one which doesn't start are filtered out. |
|
|
String for retrieving cascading lookup value, based on id of the value of lookup domain.Note : If this value is set then search parameter "input_filter_string" will be ignored. |
|
|
N/A |
Collections (28)
PUT Add Assets to the selected collections
/v6/collections/assets
Add Selected assets by creating new private collection and also add into existing collections.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
Private Collection Name |
|
|
List of Collection Ids |
|
|
Operation to be performed on the collection assets. An 'add/remove' operation expects 'selection_context' |
POST Change the collection thumbnail
/v6/collections/{id}/thumbnail
Change the collection thumbnail to the thumbnail of the specified asset id. Asset should be part of the collection
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The id of the asset to be used as the collection thumbnail, Asset should be part of the collection |
POST Create a Collection
/v6/collections
Create a collection for the given user. In the CollectionRepresentation, specify the name, permissions and rating enabled or not.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Brand id for the current logged in user |
|
|
Collection microsite action type ; allowed values are create or delete. |
DELETE Delete a Collection
/v6/collections/{id}
This collection will be delete from the system and it will no longer be accessible. This operation cannot be undone. All shared recipients will be removed from the collection and they will no longer be able to access it.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
PUT Delete a Collection
/v6/collections
This collection will be delete from the system and it will no longer be accessible. This operation cannot be undone. All shared recipients will be removed from the collection and they will no longer be able to access it.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Actions to be performed on the collection. An 'delete' action expects 'collection_list_selection_context' |
GET Get all list of access types
/v6/collections/accesstypes
Get all list of access types to share the collection
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Get collection by collection id
/v6/collections/{id}
Get collection by collection id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
GET Get list of collections for current user
/v6/collections
Get list of collections for current user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
JSON representation of ContainerFilters object to perform filtering on collections. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
GET Get list of collections promoted for current user
/v6/collections/me/promotions
Get list of collections promoted for current user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
POST Promote or demote the collection.
/v6/collections/{id}/promotions
Promote or demote the collection.All the selected user groups will be considered as promoted user groups. All the remaining user groups not selected will be consided as demoted.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
List of user groups selected for promotion. |
|
|
Brand id for the current logged in user |
POST Publish the collection.
/v6/collections/{id}/publish
Publish the collection in OTMM to generate microsite for the collection.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Brand id for the current logged in user |
POST Rate the collection.
/v6/collections/{id}/rating
Rate the shared collection as the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Rating to be added for an collection. |
DELETE Remove the collection thumbnail
/v6/collections/{id}/thumbnail
Remove the collection thumbnail to the thumbnail of the specified asset id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
GET Retrieve all assets of a Collection
/v6/collections/{id}/assets
Retrieve all the assets for the specified Collection.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
N/A |
GET Retrieve all collection sort options
/v6/collections/sortoptions
Retrieves all sort options to sorting the collections of the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all recent assets sort options
/v6/collections/assets/sortoptions
Retrieves all sort options to sort recently accessed assets of the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve assets based on the provided selection context.
/v6/collections/assets
Retrieve assets based on the provided selection context. The request needs the pagination parameters to be passed. The asset collection will also include summary about the collection. To load only collection summary pass limit as 0.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
The selection context for the assets. |
|
|
Map of asset id and container path to expand. The given path will be expanded to have children of path elements. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
N/A |
GET Retrieve collection thumbnail
/v6/collections/{id}/thumbnail
Retrieve the thumbnail for the specified collection.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
The disposition type |
|
|
Is caching enabled for this request |
|
|
User-Agent HTTP header |
|
|
N/A |
GET Retrieve list of all collection filter types.
/v6/collections/filterTypes
Retrieve list of all collection filter types.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve list of all collection filter types.
/v6/collections/sharedFilterTypes
Retrieve list of all collection filter types.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve promoted user groups in a collection.
/v6/collections/{id}/promotions
Retrieve promoted user groups in a collection.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
DELETE Unpublish the collection.
/v6/collections/{id}/unpublish
Unpublish the collection in OTMM to remove microsite for the collection.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
PATCH Update a collection
/v6/collections/{id}
Update properties of a collection selectively.
name, description, collectionType, ratingEnabled, collectionShareAccessInfo can be modified using this endpoint.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
PUT Update a collection
/v6/collections/{id}
Update properties of a collection.
CollectionSource can't be modified using this endpoint.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Collection Id |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Brand id for the current logged in user |
|
|
Collection microsite action type ; allowed values are create or delete. |
POST subscribe a collection
/v6/collections/{id}/subscriptions
subscribe a collection
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST subscribe collections
/v6/collections/subscriptions
subscribe collectionsSelection context for performing action on single/list of Collections.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Maximum number of items to retrieve. |
DELETE un-subscribe a collection
/v6/collections/{id}/subscriptions
un-subscribe a collection
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
DELETE un-subscribe of assets
/v6/collections/subscriptions
un-subscribe of assetsWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The selection context for the assets. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
Colorfilters (2)
GET Retrieve a Color Filter
/v6/colorfilters/{id}
Retrieve a Color Filter by color filter id. Color Filters are used when filtering a search result by colr. Color Filters are only supported for text based searches.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Color Filter Id. |
|
|
N/A |
GET Retrieve all Color Filters
/v6/colorfilters
Retrieve all Color Filters. Color Filters are used when filtering a search result by colr. Color Filters are only supported for text based searches.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Download
GET Download Asset
x-oneteg-downloader-path-without-authorization
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
This toggle enables you to load file content as the step output. Supported formats include JSON, XML, YML/YAML, CSV, TXT, and other text-based file types. Note that images, PDF files, and other binary formats cannot be loaded. Additionally, there is a file size limit for this feature; please check the logs for details. |
|
|
Enable or disable following URL redirects. If it is enabled, it will follow the URL redirects. |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Exports
POST Create a export schedule
/v6/exports/schedules
Create a new export schedule. If the export_contents parameter is set to assets_and_assets_list then asset metadata will not be included in the export schedule. If metadata is exported then metadata file format to export schedule should be specified in export_request parameter.While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERMIf delivery template is set to 'Email Asset URL' in export request and FolderSelectionContext is provided for the selection_context parameter then 'include_descendants' and 'child_type' flags in the selection_context object are overridden to 'IMMEDIATE' and 'ASSETS_AND_CONTAINERS' respectively. Similarly, when AssetIdsSelectionContext or SearchSelectionContext is provided for the selection_context parameter then 'include_descendants' flag is set to 'NONE' in the selection_context object
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata. |
|
|
User defined name of the export schedule. If this parameter is not set, the default value is export schedule class name. |
|
|
Create an export schedule in force mode, by updating an existing schedule delivery if it is matched with given folder id or search id |
Facetconfigurations (2)
GET Retrieve a Facet Configuration
/v6/facetconfigurations/{id}
Retrieve a Facet Configuration by facet configuration id. Facet Configurations are used to configure what facet information is returned with search results.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Facet Configuration Id |
|
|
N/A |
GET Retrieve all Facet Configurations
/v6/facetconfigurations
Retrieve all Facet Configurations. Facet Configurations are used to configure what facet information is returned with search results.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
If partial is specified only a subset of the Facet Configuration information will be retrieved. This is intended for use in generating a list of available Facet Configurations |
|
|
N/A |
Featurepermissions (2)
GET Get all supported feature permissions
/v6/featurepermissions
Get all supported feature permissions
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Get feature permissions for logged in user
/v6/featurepermissions/me
Get feature permissions for logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Folders (23)
POST Add Or Update Renditions of folder
/v6/folders/{id}/contents
Add Or Update Renditions of a folder. Supported Rendtion types are Thumbnail or Preview. The content image supported as a multipart/form-data format or asset id. Asset Id should be child of current folder
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
The rendition type |
|
|
Asset to be set as Renditions of a parent folder |
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
N/A |
PUT Add or move or remove children (Assets and Folders) to/from current Folder
/v6/folders/{id}/children
Add children to, or move children into the specified Folder or remove children from current folder. Whether an add or move or remove is performed is determined by the value assigned to the required type parameter. A move operation moves children from one Folder to another Folder. One should specify either asset_ids or selection_context parameter value in the request. A remove operation removes children from current selected Folder, which are mentioned as either asset_ids or selection_context parameter value in the request. The selection_context identifies the assets that will be part of the operation.The response of this operation includes both the Folder into which the children were inserted, a list of children successfully added or moved, and a list of children that could not be added or moved.
The failed list also specifies the reason for failure - Failure errors can be one of the following:CIRCULAR - Has circular dependencyNOT_EXIST - Folder/Asset with given id does not existASSET_NOT_ALLOWED - Assets not allowed to be childrenCONTAINER_TYPE_NOT_ALLOWED - The folder type associated with child folder is not allowed to be child or parentSINGLE_PARENT - Child folder can have only single parentWRONG_TREE - Child folder does not belong to same treeCANT_BE_ROOT - Folder/Asset cannot be rootEXISTING_CHILD - Folder/Asset already a childINACTIVE - Folder type associated with folder is inactiveNO_EDIT_PARENTS - User does not have permission on the parent folder to add or move children.CONTAINER_TYPE_NOT_ALLOWED_FOR_USER - User does not belong to allowable user groups for the folder type associated with the parent folderWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
Options (6)
|
Option Name |
Description |
|---|---|
|
|
Type of operation. |
|
|
Comma separated list of the ids of the children to add or move |
|
|
For move operations, the id of the Folder in which all children are currently located. This parameter is required for move operations and ignored for add operations |
|
|
Method used to determine the position of the new children in the Folder |
|
|
If position_type is absolute the numeric position where the new children should be inserted into the existing children. If not specified the new children will be position after all existing children. If position_type is relative then you must specify either before or after to determine where the new children are inserted relative to the existing child identified by the relative_asset_id parameter. |
|
|
If position_type is relative then this parameter must be set to the asset id of the existing child relative to which new children should be added or moved. If position_type is absolute this parameter is ignored |
POST Create a Folder
/v6/folders/{id}
Create a sub-folder under the specified Folder. In the supplied FolderRepresentation, one needs to set only folder name, folder type id, metadata and security policies. In metadata, set only field id and value.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
DELETE Delete Renditions of folder
/v6/folders/{id}/contents
Remove Renditions of a folder
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
DELETE Delete a Folder
/v6/folders/{id}
Mark the specified Folder as DELETED. The Folder is not purged from the system.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
POST Duplicate the given asset/folder.
/v6/folders/{id}/duplicate
Duplicate the given asset/folder to the destination folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
Destination folder id to move, copy or duplicate assets |
|
|
Method used to determine the position of the new children in the Folder |
|
|
If position_type is absolute the numeric position where the new children should be inserted into the existing children. If not specified the new children will be position after all existing children. If position_type is relative then you must specify either before or after to determine where the new children are inserted relative to the existing child identified by the relative_asset_id parameter. |
|
|
If position_type is relative then this parameter must be set to the asset id of the existing child relative to which new children should be added or moved. If position_type is absolute this parameter is ignored |
|
|
Depth to traverse when duplicating containers. Less than zero means traverse all the way down. |
PUT Lock or unlock or un-delete of a folder
/v6/folders/{id}/state
Lock or unlock or un-delete of a folder
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Folder 'state change' action; allowed values are lock, unlock, delete, un_delete |
PUT Remove list of specified parents for Folder Id.
/v6/folders/{id}/parents
Remove parents which are mentioned in comma separated parentIds string for current folder resource.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
Type of operation. |
|
|
Comma separated list of the parent's ids to be detached |
GET Retrieve a Folder
/v6/folders/{id}
Retrieve a Folder by folder id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Map of asset id and container path to expand. The given path will be expanded to have children of path elements. |
|
|
JSON representation of AssetFilterRequest objcet to perform filtering on assets |
|
|
N/A |
GET Retrieve a rendition of a Folder
/v6/folders/{id}/contents
Retrieve a rendition for the specified Folder. Folders may optionally have either thumbnail or preview renditions.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
The rendition type |
|
|
The disposition type |
|
|
Is caching enabled for this request |
|
|
User-Agent HTTP header |
|
|
N/A |
GET Retrieve all Assets in a Folder
/v6/folders/{id}/assets
Retrieve all Assets in the specified Folder.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
JSON representation of AssetFilterRequest objcet to perform filtering on assets |
|
|
N/A |
GET Retrieve all Root Folders
/v6/folders/rootfolders
Retrieve all system Root Folders.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Should a child count be returned for each root folder |
|
|
N/A |
GET Retrieve all child Folders in a Folder
/v6/folders/{id}/folders
Retrieve all child Folders in the specified Folder. If the request is for the first page or all folders within a system Root Folder, the Public Orphans or My Orphans is also retrieved.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
JSON representation of AssetFilterRequest objcet to perform filtering on assets |
|
|
N/A |
GET Retrieve all children (Assets and Folders) of a Folder
/v6/folders/{id}/children
Retrieve all the children, both Assets and Folders, of the specified Folder.You can distinguish between the Folders and Assets in the response with the help of the type field. The type field is present only for Folders and has the value com.artesia.container.Container.
The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
JSON representation of AssetFilterRequest objcet to perform filtering on assets |
|
|
N/A |
GET Retrieve all folder Sort Options
/v6/folders/sortoptions
Retrieves all Sort Options available for sorting folder content. These options can be used when retrieving the children of a folder, the assets with in a folder, or the subfolders of a folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all recent folders sort options
/v6/folders/recent/sortoptions
Retrieves all Sort Options to sort recently accessed folders of the logged in user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve assigned property templates of a folder
/v6/folders/{id}/templates
Retrieve all content specific Property templates including default property template of a folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
N/A |
GET Retrieve recent Folders
/v6/folders/recent
Retrieve all recently accessed folders of the logged in user.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
JSON representation of AssetFilterRequest objcet to perform filtering on assets |
|
|
N/A |
GET Retrieve the parents for given asset id.
/v6/folders/{id}/parents
Retrieve the parents for given asset id.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
PATCH Update a folder
/v6/folders/{id}
Update metadata and/or reassign applicable security policies for the specified folder.
For Metadata Fields, only the type, Id and value need to be specified. For security policies,
only the teams identifier(s) need to be specified.
The asset must be locked by the user who is performing the edit operation.
If the value for lockStrategy parameter passed is optimistic, then the user doesn't need to lock the asset prior to calling.The API will obtain the lock internally and perform the asset update
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Id |
|
|
Lock Strategy: allowed values are optimistic,default. |
|
|
N/A |
PUT Update property templates of a folder
/v6/folders/{id}/templates
Update all content specific Property templates including default property template of a folder.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST subscribe of an asset
/v6/folders/{id}/subscriptions
subscribe of an asset
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
DELETE un-subscribe of an asset
/v6/folders/{id}/subscriptions
un-subscribe of an asset
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Foldertypes (2)
GET Retrieve a Folder Type
/v6/foldertypes/{id}
Retrieve a Folder Type by folder type id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Folder Type Id |
|
|
N/A |
GET Retrieve all Folder Types
/v6/foldertypes
Retrieve all Folder Types. Optionally just Folder Types that are configued as active, Folder Types that the user has permission to create Folders with, or Folder Types that are configured as valid for creating top level folders can be retrieved. These options can be combined.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Retrieve only Folder Types configured as active |
|
|
Retrieve only Folder Types that the user has permission to create Folders with |
|
|
Retrieve only Folder Types configured as valid for creating top level Folders |
|
|
N/A |
Hightail (5)
GET Callback to generate Hightail Oauth2 Tokens
/v6/hightail/tokens/oauth2
Callback to generate Hightail Oauth2 Tokens.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Oauth2 Code |
|
|
Oauth2 State |
|
|
Oauth2 Error |
|
|
Oauth2 Error Description |
|
|
N/A |
POST Create a Hightail Space
/v6/hightail/spaces
Create a Hightail Space.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
Space type |
|
|
Space name |
|
|
Space description |
DELETE Logout Hightail Access Token
/v6/hightail/tokens
Logout the cached Hightail Access Token.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve User Contacts
/v6/hightail/contacts
Retrieve User Contacts.
Contacts will be retrieved from both Hightail send/share address book and users configured in OTMM.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Filter by user's first and last name. This parameter supports wildcards. |
|
|
Indicates whether to retrieve contacts for use with a Hightail based Review Job |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
POST Validate Hightail Access Token
/v6/hightail/tokens/validations
Validate that the cached Hightail Access Token is valid.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Importtemplates
GET Retrieve all Property Templates
/v6/importtemplates
Retrieve all Permissible Property Templates.For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
JSON Representation of ImportTemplateDataLoadRequest object |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
N/A |
Intervalprofiles (2)
GET Retrieve all Interval Profiles
/v6/intervalprofiles
Retrieve all Interval Profiles. Interval Profiles are used to implement Interval Facets in a Facet Configuration. Either the full Interval Profile representation can be retrieved, or just a partial representation. A partial representation does not include the interval definitions, and is intended for use in generating a list of available Interval Profiles.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The retrieval type |
|
|
The profile types |
|
|
N/A |
GET Retrieve an Interval Profile
/v6/intervalprofiles/{id}
Retrieve an Interval Profile by interval profile id. Interval Profiles are used to implement Interval Facets in a Facet Configuration.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Interval Profile Id. |
|
|
N/A |
Jobs (21)
PUT Attach Content for specified metadata only asset(s)
/v6/jobs/attachcontents/{import_job_id}
Attach Content for specified metadata only asset(s). This should be a multipart/form-data request. The operation creates an attachcontent job and returns the job handle. Using the job id in job handle, you can query the 'jobs' resource for completion status.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
Name of the job to be triggered on the server. If this parameter is not set, the default value will be picked from settings. This parameter has highest precedence while deciding the job to trigger. |
|
|
Callback URL in the encoded form, which needs to be notified once the job is complete. For more information on the format of callbackURl , refer to integration guide. |
POST Create a new export job
/v6/jobs/exports
Create a new export job. If the export_contents parameter is set to assets_and_assets_list then asset metadata will not be included in the export. If metadata is exported then metadata file format to export should be specified in export_request parameter.While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERMIf delivery template is set to 'Email Asset URL' in export request and FolderSelectionContext is provided for the selection_context parameter then 'include_descendants' and 'child_type' flags in the selection_context object are overridden to 'IMMEDIATE' and 'ASSETS_AND_CONTAINERS' respectively. Similarly, when AssetIdsSelectionContext or SearchSelectionContext is provided for the selection_context parameter then 'include_descendants' flag is set to 'NONE' in the selection_context object
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (6)
|
Option Name |
Description |
|---|---|
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata |
|
|
Preference id to be honored during operation on assets and metadata during an export job. This parameter is ignored unless the load_type parameter is set to metadata |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata. |
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
Name of the job to be triggered on the server. If this parameter is not set, the default value will be picked from settings. This parameter has highest precedence while deciding the job to trigger. |
POST Create a new job
/v6/jobs
Instantiates a new job and returns the job handle holding id of the new job
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Create an import job
/v6/jobs/imports
Create an import job to upload content and create asset(s) against. The Job Id in the returned job handle can be used to upload content for the import job against the 'renditions' resource.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
PUT Create version for specified Asset(s)
/v6/jobs/checkins/{import_job_id}
Create Asset(s) version for the specified asset(s). This should be a multipart/form-data request. The operation creates an checkin job and returns the job handle. Using the job id in job handle, you can query the 'jobs' resource for completion status.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
Name of the job to be triggered on the server. If this parameter is not set, the default value will be picked from settings. This parameter has highest precedence while deciding the job to trigger. |
|
|
The id of the job from where import is initiated. |
|
|
The id of the task from where import is initiated. |
|
|
Callback URL in the encoded form, which needs to be notified once the job is complete. For more information on the format of callbackURl , refer to integration guide. |
GET Get Jobs information for current user
/v6/jobs
Get Jobs for current user with filters.
Note :
1. Parameter job_class will have precedence over job_type. If job_class is present, job_type will be ignored.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve.If limit is set to zero then only collection summary is returned assuming that the request is made only to retrieve the counts.If limit is not passed, the default limit will be picked from the 'JOB_LIST_RECORD_COUNT' setting. |
|
|
Comma separated list of status ids. Use the '/statusoptions' resource to get the list of statuses |
|
|
Comma separated list of assigned roles. Use the '/roleoptions' resource to get the list of assigned roles |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). Sorting on jobs is supported for the fields job_name, job_class, start_time, end_time, status. For sorting the results by status, the status values COMPLETED, ERROR and WARN are treated alike as all these statuses are considered as 'end' in BPM server |
|
|
Flag to load job data |
|
|
Flag to load job details. If set to true, will load job details. |
|
|
Flag to load asset ids and asset count are part of job. If set to true, will load asset details. |
|
|
Flag to load job form(prelaunch form) |
|
|
Maximum number of asset ids to retrieve. This parameter is honored only when load_asset_details is set to true. If limit is not passed, the default limit will be picked from the 'ASSET_IDS_TO_LOAD_INTO_JOB' setting. |
|
|
Flag to load steps |
|
|
Flag to load only downloadable jobs |
|
|
Flag to load the jobs those have inprogress task |
|
|
Filter to retrieve Jobs based on the job's type. Parameter can be set to a comma separated list of job types. |
|
|
Job class to be used to filter jobs. |
|
|
Date Range for retrieveing jobs by creation date. Dates ranges are calculate w.r.t server time. |
|
|
Date Range for retrieving jobs by completion date. Dates ranges are calculate w.r.t server time. |
|
|
Date Range for retrieving jobs by completion date. Dates ranges are calculate w.r.t server time. |
|
|
Retrieving jobs by end date range, starting limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Name of the job category: System or Custom |
|
|
Retrieving jobs by end date range,ending limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving jobs by start date range, starting limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving jobs by start date range, ending limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
N/A |
GET Get all job users
/v6/jobs/{id}/users
Get all the job users who are participated in the job. The list includes both participants and assignees
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
N/A |
GET Get job contents
/v6/jobs/{id}/exports/contents
Get contents of a job by job id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
User-Agent HTTP header |
|
|
Is caching enabled for this request |
|
|
N/A |
GET Get related tasks information for a job id
/v6/jobs/{id}/tasks
Get related tasks information for a job id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
N/A |
PUT Register Assets for creation
/v6/jobs/imports/{import_job_id}
Register Asset(s) for creation with the specified asset representation or import template. This should be a multipart/form-data request. The operation creates an import job and returns the job handle. Using the job id in job handle, you can query the 'jobs' resource for completion status.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (10)
|
Option Name |
Description |
|---|---|
|
|
Id of the import template to use |
|
|
The parent folder id |
|
|
The review job id |
|
|
The review job task id |
|
|
The id of the job from where import is initiated. |
|
|
The id of the task from where import is initiated. |
|
|
User defined name of the job. If this parameter is not set, the default value is job class name. |
|
|
Name of the job to be triggered on the server. If this parameter is not set, the default value will be picked from settings. This parameter has highest precedence while deciding the job to trigger. |
|
|
Callback URL in the encoded form, which needs to be notified once the job is complete. For more information on the format of callbackURl , refer to integration guide. |
|
|
Flag indicating whether folder hierarchies should be merged with existing hierarchies. Default is create hierarchies without merging into existing hierarchies. This flag is optional and will be considered only if assets are uploaded with hierarchy. |
GET Retrieve a specific user job
/v6/jobs/{id}
Retrieve user job by id. This operation is allowed for user who triggered the job and system administrator
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
Flag to load job data |
|
|
Flag to load job details. If set to true, will load job details. |
|
|
Flag to load asset ids and asset count are part of job. If set to true, will load asset details. |
|
|
Maximum number of asset ids to retrieve. This parameter is honored only when load_asset_details is set to true. If limit is not passed, the default limit will be picked from the 'ASSET_IDS_TO_LOAD_INTO_JOB' setting. |
|
|
Flag to load steps |
|
|
Flag to load in-progress tasks information. The return object includes user assignment details of the task |
|
|
Flag to load job form(prelaunch form) |
|
|
N/A |
GET Retrieve all Job definitions.
/v6/jobs/definitions
Retrieves all Job definitions that the user has access to. User can instantiate only those jobs returned by this api.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Name of the job to filter jobs. |
|
|
Flag to load steps |
|
|
Flag to load all versions of the job definitions |
|
|
N/A |
GET Retrieve all Status Options for Jobs
/v6/jobs/statusoptions
Retrieves all supported Status Options available for retrieving Jobs.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all Status Options for Jobs
/v6/jobs/stepstatusoptions
Retrieves all supported Status Options available for retrieving Jobs.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all assignee roles for job
/v6/jobs/roleoptions
Retrieves all supported assignee roles options available for retrieving Jobs.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all jobs Sort Options
/v6/jobs/sortoptions
Retrieves all Sort Options available for sorting jobs contents.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve assets for job
/v6/jobs/{id}/assets
Retrieve assets associated with a job by job id. This operation is allowed for user who triggered the job and system administratorThe fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve.If limit is set to zero then only collection summary is returned assuming that the request is made only to retrieve the counts. |
|
|
Specify the task id to skip the assets which are present in the task while retrieving the job assets. |
|
|
N/A |
GET Retrieve pre launch form.
/v6/jobs/{name}/forms
Retrieve pre launch form associated with the given activity name
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Name of the activity to retrieve pre launch form which is configured to the activity |
|
|
N/A |
PUT Sets status of a specific user job
/v6/jobs/{id}/state
Sets job status for a user job and all sub jobs instantiated from current job. This operation is allowed for user who triggered the job.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be retrieved |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Job State to set. Current allowed value is 'end' only. |
PATCH Update jobs
/v6/jobs
Add assets to all the given jobs. The assets will be added only to the jobs which are triggered by the requested user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Comma separated list of job id's |
PATCH Updates the Job data.
/v6/jobs/{id}
Updates the Job data.
Note :
1. Currently it only updates content downloaded flag, anything else passed will be ignored.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the job to be updated |
|
|
N/A |
Linktypes
GET Retrieve all Link Types
/v6/linktypes
Retreive all Link Types.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Lookupdomains (2)
GET Retrieve a Lookup Domain
/v6/lookupdomains/{id}
Retrieve a Lookup Domain by lookup domain id. Only valid domain values are populated. Expired values are excluded.
If search string is provided it returns only lookup domain id along with domain values matching the search string and other information related to lookup domain will be filtered out.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Lookup Domain Id |
|
|
search string for filtering Lookup Domain values |
|
|
If true, search only for domain values starting with search string |
|
|
N/A |
GET Retrieve all Lookup Domains
/v6/lookupdomains
Retrieve all Lookup Domains. In each of the retrieved Lookup Domains, only the valid domain values are populated. Expired values are excluded.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
MarsExtn (9)
GET To get the output from OTMM databse
/v6/MarsExtn/custom-query/lighthouse/assets-imported-by-date-range
get the query output
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Encrypt the given String
/v6/MarsExtn/chili-xml
Encrypt the given String
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Encrypt the given String
/v6/MarsExtn/tool/password/encrypt
Encrypt the given String
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Get Audit Data based on Events and Time range
/v6/MarsExtn/custom-query/lightbulb/assets-with-audits-by-date-range
Based on Event Id and Time Range information as input, the Audit information is given as distinct asset-ids from the Audit Table
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Get Derived template asset Id and JobId
/v6/MarsExtn/custom-query/lighthouse/findJobsByAssetId
Get Derived template asset Id and JobId from db table
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Send email when error occurs in template creation process for an asset
/v6/MarsExtn/support-tool/trigger-template-process-error-email
send email when template creation/process fails. assetId of asset is required
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
N/A |
|
|
Primary recepient |
|
|
Secondary recepient |
POST Unflag Incorrect Metadata when a job is aborted in activities tab
/v6/MarsExtn/unflagIncorrectMetadata
Unflag an Asset as incorrect Metadata and close the job
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
PATCH Update Percolate Metadata Status Field
/v6/MarsExtn/percolate/intake-request-status/{otmmAssetId}
Update Percolate Metadata Status Field
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id in Lighthouse |
|
|
N/A |
PATCH Update Salsify Metadata Date Field
/v6/MarsExtn/salsify/update-field/{assetId}
Update Salsify Metadata Date Field
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id in Lighthouse |
|
|
N/A |
Metadatafieldgroups (2)
GET Retrieve a Metadata Field Group
/v6/metadatafieldgroups/{id}
Retrieve a Metadata Field Group by metadata field group id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Metadata Field Group Id |
|
|
N/A |
GET Retrieve all Metadata Field Groups
/v6/metadatafieldgroups
Retrieve all Metadata Field Groups.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Metadatafields (2)
GET Retrieve a Metadata Field
/v6/metadatafields/{id}
Retrieve a Metadata Field by metadata field id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Metadata Field Id |
|
|
N/A |
GET Retrieve all Metadata Fields
/v6/metadatafields
Retrieve all Metadata Fields. Optionally the Metadata Fields returned can be limited using the id parameter.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Comma separated list of metadata field ids to retrieve. |
|
|
N/A |
Metadatalocales
GET Retrieve all Metadata Locales
/v6/metadatalocales
Retrieve all Metadata Locales.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Metadatamodels (2)
GET Retrieve Metadata Models for specified object type.
/v6/metadatamodels
Retrieve Metadata Models for specified object type. If object type provided is null, it retrieves all models in the system. If model doesn't have type been set, then it considered for all.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Model Object Type |
|
|
N/A |
GET Retrieve a Metadata Model
/v6/metadatamodels/{id}
Retrieve a Metadata Model by metadata model id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Metadata Model Id |
|
|
N/A |
Preferences (5)
GET Get all user preferences
/v6/preferences
Get all user preferences for logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Get user preference by preference id
/v6/preferences/{preference_id}
Get the user preference by preference id for logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Preference id |
|
|
N/A |
GET Get user preference date ranges
/v6/preferences/dateranges
Get the user preference by preference id for logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
PUT Set user preference by preference id
/v6/preferences/{preference_id}
Set the user preference by preference id to logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Preference id |
|
|
N/A |
PATCH Set user preferences
/v6/preferences
Set user preferences to logged in user
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Renditions (2)
POST Create a rendition for an earlier created import job
/v6/renditions
Create a rendition for an earlier created import job, this method also supports chunk file upload.To enable chunk file upload, client must set request header "X-USES-CHUNKS" as "true" and include chunk parameters as part of the rest client request.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (9)
|
Option Name |
Description |
|---|---|
|
|
The id of the import job as part of which the asset(s) is(are) being created. |
|
|
The file name for the rendition. If specified, overrides the file name set in the 'file' part's Content-Disposition header |
|
|
The path of the file relative to the import working directory. |
|
|
N/A |
|
|
Upload chunk size. |
|
|
File size. |
|
|
Unique file identifier. |
|
|
Total number of chunks for file. |
|
|
Upload chunk index. |
GET Retrieve a Rendition
/v6/renditions/{id}
Retrieve a Rendition associated with an Asset or Folder by rendition id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Rendition Id |
|
|
The disposition type |
|
|
Is caching enabled for this request |
|
|
User-Agent HTTP header |
|
|
Collection Id |
|
|
N/A |
Savedsearches (10)
POST Change the Saved Search thumbnail
/v6/savedsearches/{id}/thumbnail
Change the Saved Search thumbnail
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The id of the asset to be used as the Saved Search thumbnail |
POST Create a database Saved Search
/v6/savedsearches/database
Create a database based Saved Search.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (7)
|
Option Name |
Description |
|---|---|
|
|
Saved Search name |
|
|
Saved Search description |
|
|
Saved Search public flag |
|
|
Saved Search favorite flag |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
List of user groups to be associated with the saved search. Only users belonging to these groups or sub groups can use this search |
POST Create a new Saved Search from an existing Saved Search
/v6/savedsearches/saved
Create a new Saved Search from an existing Saved Search.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (8)
|
Option Name |
Description |
|---|---|
|
|
Saved Search name |
|
|
Saved Search description |
|
|
Saved Search public flag |
|
|
Saved Search favorite flag |
|
|
Saved Search Id |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Facet Configuration Id |
|
|
List of user groups to be associated with the saved search. Only users belonging to these groups or sub groups can use this search |
POST Create a text Saved Search
/v6/savedsearches/text
Create a text based Saved Search.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (21)
|
Option Name |
Description |
|---|---|
|
|
Saved Search name |
|
|
Saved Search Id |
|
|
Saved Search description |
|
|
Saved Search public flag |
|
|
Saved Search favorite flag |
|
|
The keyword search query |
|
|
The keyword scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
A keyword query that can be used to filter search results |
|
|
The keyword filter scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Search Configuration Id. This parameter cannot be used if either the fixed_condition_list or candidate_field_list parameters have been specified. |
|
|
Sets whether the UI should allow keyword search conditions to be added to this search. This parameter will be ignored if a search_config_id parameter has been specified. To execute a search based on a Search Configuration, specifying the search_config_id parameter is recommended. This parameter can be used if a saved search based on a Search Configuration has been retrieved, and you wish to modify and re-execute the search and retain the Keyword Search Allowed property inherited from the Search Configuration. |
|
|
The default operatorIf not specified then set using the Tresource [SEARCH\SERVER] DEFAULT_OPERATOR entry |
|
|
Facet Configuration Id |
|
|
Allows you to filter your search result to include only assets that are part of one of the specified list of collections. Specify a comma separated list of the ids of the collections to be used to filter results. |
|
|
Allows you to filter your search result to include only assets whose score for the specified color exceeds the configured threshold. Specify the id of the color to be used to filter results. |
|
|
Allows you to filter your search result to include only descendants of the specified folder. Specify the id of the folder to be used to filter results. The folder_filter_type parameter can be used to modify the behavior of the folder filter. |
|
|
Modifies the behavior of the folder_filter parameter. If set to all all descendants of the specified folder are included in the filtered result. If set to direct only the immediate children of the specified folder are included in the filtered result. This parameter is ignored if the folder_filter parameter is not set. |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
If searching multilingual fields, allows you to specify the code of the language varient to search against |
|
|
List of user groups to be associated with the saved search. Only users belonging to these groups or sub groups can use this search |
DELETE Delete a Saved Search
/v6/savedsearches/{id}
Delete a Saved Search by saved search id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
GET Retrieve Saved Search sort options
/v6/savedsearches/sortoptions
Retrieve all supported options for overriding the default sort order of Saved Searches
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve a Saved Search
/v6/savedsearches/{id}
Retrieve a Saved Search by saved search id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
GET Retrieve all Saved Searches
/v6/savedsearches
Retrieves all Saved Searches. Optionally just Saved Searches of a specific type (public, restricted or private) can be retrieved, or Saved Searches can be retrieved by id by specifying selected as the save_type and populating a comma separated list of Saved Search ids in the search_ids parameter. Either the full Saved Search representation can be retrieved, just a partial representation, or a partial representation with the sort conditions added. A partial representation does not include the search criteria or sort conditions, and is intended for use in generating a list of available Saved Searches.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The retrieval type |
|
|
The saved search type |
|
|
Comma separated list of ids of the Saved Searches to retrieve. This parameter is ignored unless save_type is set to selected. Note that the paging related parameters will be ignored when retrieving Saved Searches by id. |
|
|
Allows you to override the default sort order. Specify the property to sort Saved Searches on. Prefix with asc_ (default) or desc_ to specify the order |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
PUT Update a Saved Search
/v6/savedsearches/{id}
Update a Saved Search by saved search id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
PATCH Update properties of a Saved Search
/v6/savedsearches/{id}
Update properties of a Saved Search by saved search id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
Saved Search name |
|
|
Saved Search description |
|
|
Saved Search public flag |
|
|
Saved Search favorite flag |
|
|
List of user groups to be associated with the saved search. Only users belonging to these groups or sub groups can use this search |
ScreenDragonIntegration (3)
POST Check if Screendragon User exists
/v6/ScreenDragonIntegration/validateSDUserExists
This endpoint returns true if a LH user exists in SD system, false otherwise
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
N/A |
POST Create Form
/v6/ScreenDragonIntegration/sendToScreenDragon
Create Form in ScreenDragon
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
N/A |
GET Test api
/v6/ScreenDragonIntegration/Test
Test api
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Search (8)
GET Execute a Saved Search
/v6/search/saved/{id}
Generate a search result from a Saved Search.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
Facet Configuration Id |
|
|
Generated facets for this search |
|
|
JSON representation of the FacetRestriction List object |
|
|
If true any facet restrictions or keyword filters passed in will be merged with the facet restrictions and keyword filters inherited from the saved search. If false the facet restrictions and keyword filters from the saved search will be ignored, and the passed in facet_restriction_list and keyword_filter parameters (if any) will be used exclusively. |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
A keyword query that can be used to filter search results |
|
|
The keyword filter scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
The keyword search query. If specified, this overrides any keyword query present in the saved search. |
|
|
The keyword scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Ignore the original keyword search query present in the saved search. If a keyword_query parameter has been specified, the original keyword search query will always be ignored regardless of how this parameter is set. |
|
|
JSON representation of the SearchCondition List object. If specified, this overrides any condition list present in the saved search.The SearchCondition sub types supported is dependent on the search plugin the saved search is based on. |
|
|
Ignore the original search condition list present in the saved search. If a search_condition_list parameter has been specified, the original search condition list will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only assets that are part of one of the specified list of collections. Specify a comma separated list of the ids of the collections to be used to filter results. If specified, this overrides any collection filter present in the saved search. |
|
|
Ignore the original collection filter present in the saved search. If a collection_filter parameter has been specified, the original collection filter will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only assets whose score for the specified color exceeds the configured threshold. Specify the id of the color to be used to filter results.If specified, this overrides any color filter present in the saved search. |
|
|
Ignore the original color filter present in the saved search. If a color_filter parameter has been specified, the original color filter will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only descendants of the specified folder. Specify the id of the folder to be used to filter results. If specified, this overrides any folder filter present in the saved search. The folder_filter_type parameter can be used to modify the behavior of the folder filter. |
|
|
Modifies the behavior of the folder_filter parameter. If set to all all descendants of the specified folder are included in the filtered result. If set to direct only the immediate children of the specified folder are included in the filtered result. This parameter is ignored if the folder_filter parameter is not set. |
|
|
Ignore the original folder filter present in the saved search. If a folder_filter parameter has been specified, the original folder filter will always be ignored regardless of how this parameter is set. |
|
|
If searching multilingual fields, allows you to specify the code of the language varient to search against. If specified, this overrides any language varient code present in the saved search. |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
|
|
N/A |
POST Execute a Saved Search
/v6/search/saved/{id}
Generate a search result from a Saved Search.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Saved Search Id |
|
|
N/A |
Options (33)
|
Option Name |
Description |
|---|---|
|
|
Facet Configuration Id |
|
|
Generated facets for this search |
|
|
If true any facet restrictions or keyword filters passed in will be merged with the facet restrictions and keyword filters inherited from the saved search. If false the facet restrictions and keyword filters from the saved search will be ignored, and the passed in facet_restriction_list and keyword_filter parameters (if any) will be used exclusively. |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
A keyword query that can be used to filter search results |
|
|
The keyword filter scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
The keyword search query. If specified, this overrides any keyword query present in the saved search. |
|
|
The keyword scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Ignore the original keyword search query present in the saved search. If a keyword_query parameter has been specified, the original keyword search query will always be ignored regardless of how this parameter is set. |
|
|
Ignore the original search condition list present in the saved search. If a search_condition_list parameter has been specified, the original search condition list will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only assets that are part of one of the specified list of collections. Specify a comma separated list of the ids of the collections to be used to filter results. If specified, this overrides any collection filter present in the saved search. |
|
|
Ignore the original collection filter present in the saved search. If a collection_filter parameter has been specified, the original collection filter will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only assets whose score for the specified color exceeds the configured threshold. Specify the id of the color to be used to filter results.If specified, this overrides any color filter present in the saved search. |
|
|
Ignore the original color filter present in the saved search. If a color_filter parameter has been specified, the original color filter will always be ignored regardless of how this parameter is set. |
|
|
Allows you to filter your search result to include only descendants of the specified folder. Specify the id of the folder to be used to filter results. If specified, this overrides any folder filter present in the saved search. The folder_filter_type parameter can be used to modify the behavior of the folder filter. |
|
|
Modifies the behavior of the folder_filter parameter. If set to all all descendants of the specified folder are included in the filtered result. If set to direct only the immediate children of the specified folder are included in the filtered result. This parameter is ignored if the folder_filter parameter is not set. |
|
|
Ignore the original folder filter present in the saved search. If a folder_filter parameter has been specified, the original folder filter will always be ignored regardless of how this parameter is set. |
|
|
If searching multilingual fields, allows you to specify the code of the language varient to search against. If specified, this overrides any language varient code present in the saved search. |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
GET Perform a database based Search
/v6/search/database
Generate a search result from the database search engine.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
JSON representation of the SearchCondition List objectDatabase search supports the following SearchCondition sub types:SearchMetadataCondition |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
|
|
N/A |
POST Perform a database based Search
/v6/search/database
Generate a search result from the database search engine.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (17)
|
Option Name |
Description |
|---|---|
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
GET Perform a text based Search
/v6/search/text
Generate a search result from the text search engine.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The keyword search query |
|
|
The keyword scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
JSON representation of the SearchCondition List objectText search supports the following SearchCondition sub types:SearchScalarConditionSearchTabularConditionSearchFulltextCondition |
|
|
Search Configuration Id. This parameter cannot be used if either the fixed_condition_list or candidate_field_list parameters have been specified. |
|
|
JSON representation of the Fixed SearchCondition List object. This parameter cannot be used if a search_config_id parameter has been specified. To execute a search based on a Search Configuration, specifying the search_config_id parameter is recommended. This parameter can be used if a saved search based on a Search Configuration has been retrieved, and you wish to modify and re-execute the search and retain the Fixed SearchCondition List inherited from the Search Configuration. Text search supports the following SearchCondition sub types in the Fixed SearchCondition List:SearchScalarConditionSearchTabularCondition |
|
|
JSON representation of the CandidateFieldListParam object. This parameter cannot be used if a search_config_id parameter has been specified. To execute a search based on a Search Configuration, specifying the search_config_id parameter is recommended. This parameter can be used if a saved search based on a Search Configuration has been retrieved, and you wish to modify and re-execute the search and retain the Candidate Field List inherited from the Search Configuration. |
|
|
Sets whether the UI should allow keyword search conditions to be added to this search. This parameter will be ignored if a search_config_id parameter has been specified. To execute a search based on a Search Configuration, specifying the search_config_id parameter is recommended. This parameter can be used if a saved search based on a Search Configuration has been retrieved, and you wish to modify and re-execute the search and retain the Keyword Search Allowed property inherited from the Search Configuration. |
|
|
The default operatorIf not specified then set using the Tresource [SEARCH\SERVER] DEFAULT_OPERATOR entry |
|
|
Facet Configuration Id |
|
|
Generated facets for this search |
|
|
JSON representation of the FacetRestriction List object |
|
|
A keyword query that can be used to filter search results |
|
|
The keyword filter scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Allows you to filter your search result to include only assets that are part of one of the specified list of collections. Specify a comma separated list of the ids of the collections to be used to filter results. |
|
|
Allows you to filter your search result to include only assets whose score for the specified color exceeds the configured threshold. Specify the id of the color to be used to filter results. |
|
|
Allows you to filter your search result to include only descendants of the specified folder. Specify the id of the folder to be used to filter results. The folder_filter_type parameter can be used to modify the behavior of the folder filter. |
|
|
Modifies the behavior of the folder_filter parameter. If set to all all descendants of the specified folder are included in the filtered result. If set to direct only the immediate children of the specified folder are included in the filtered result. This parameter is ignored if the folder_filter parameter is not set. |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
If searching multilingual fields, allows you to specify the code of the language varient to search against |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
|
|
N/A |
POST Perform a text based Search
/v6/search/text
Generate a search result from the text search engine.The fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (31)
|
Option Name |
Description |
|---|---|
|
|
The keyword search query |
|
|
The keyword scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Search Configuration Id. This parameter cannot be used if either the fixed_condition_list or candidate_field_list parameters have been specified. |
|
|
Sets whether the UI should allow keyword search conditions to be added to this search. This parameter will be ignored if a search_config_id parameter has been specified. To execute a search based on a Search Configuration, specifying the search_config_id parameter is recommended. This parameter can be used if a saved search based on a Search Configuration has been retrieved, and you wish to modify and re-execute the search and retain the Keyword Search Allowed property inherited from the Search Configuration. |
|
|
The default operatorIf not specified then set using the Tresource [SEARCH\SERVER] DEFAULT_OPERATOR entry |
|
|
Facet Configuration Id |
|
|
Generated facets for this search |
|
|
A keyword query that can be used to filter search results |
|
|
The keyword filter scope id1 - Metadata2 - File Content3 - Metadata and Content |
|
|
Allows you to filter your search result to include only assets that are part of one of the specified list of collections. Specify a comma separated list of the ids of the collections to be used to filter results. |
|
|
Allows you to filter your search result to include only assets whose score for the specified color exceeds the configured threshold. Specify the id of the color to be used to filter results. |
|
|
Allows you to filter your search result to include only descendants of the specified folder. Specify the id of the folder to be used to filter results. The folder_filter_type parameter can be used to modify the behavior of the folder filter. |
|
|
Modifies the behavior of the folder_filter parameter. If set to all all descendants of the specified folder are included in the filtered result. If set to direct only the immediate children of the specified folder are included in the filtered result. This parameter is ignored if the folder_filter parameter is not set. |
|
|
Comma separated list of sort fields. Field ids can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
The search plugin id |
|
|
Generate type counts for this search |
|
|
Apply search filter user preferences for this search |
|
|
If searching multilingual fields, allows you to specify the code of the language varient to search against |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Attribute to group and count the assets in a asset collection |
|
|
The amount of information to be passed back in the responseThe following return types are supported:count - only the number of assets matching the query will be returned. Parameters other than the search criteria will be ignoredids - asset ids returnedobjects - asset objects returnedall - both ids and objects returned |
|
|
If true the SDK search object generated for this search is returned in the SearchResultRepresentation |
|
|
Optional notes on the context in which this search is being performed. This parameter has no impact on the search execution and is not persisted when searches are saved, but if the return_search_object parameter is set to true will be passed back with the search result. |
GET Retrieve all search Sort Options
/v6/search/sortoptions
Retrieves all Sort Options available for sorting search results.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve search suggestions
/v6/search/text/suggestions
Retrieve search suggestions for the specified input string.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The input suggestions are being requested for |
|
|
The search plugin id |
|
|
Maximum number of search suggestions to retrieve. If not specified the value defined in the DEFAULT_MAX_SUGGESTIONS setting will be used. |
|
|
Id of the index suggestions will be generated from. If not specified the value defined in the DEFAULT_SUGGESTION_INDEX_ID setting will be used. |
|
|
N/A |
Searchconfigurations (2)
GET Retrieve a Search Configuration
/v6/searchconfigurations/{id}
Retrieve a Search Configuration by search configuration id. Search Configurations are used to implement Advanced Search.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Search Configuration Id. |
|
|
N/A |
GET Retrieve all Search Configurations
/v6/searchconfigurations
Retrieve all Search Configurations. Search Configurations are used to implement Advanced Search. Either the full Search Configuration representation can be retrieved, or just a partial representation. A partial representation does not include the search criteria, and is intended for use in generating a list of available Search Configurations.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The retrieval type |
|
|
N/A |
Searchoperators
GET Retrieve all Search Operators
/v6/searchoperators
Retrieve all Search Operators. Search Operators are used when creating fielded search conditions. Not all Search Operators are supported for text based searches. The subset of operators valid for text based searches can be retrieved by using the search_type parameter.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The search type |
|
|
N/A |
Searchscopes
GET Retrieve all Search Scopes
/v6/searchscopes
Retrieve all Search Scopes. Search Scopes are used when performing keyword searches to specify what data will be searched.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Securitypolicies (3)
GET Retrieve Security Policy permissions for all User Groups or retrieves only Security Policies with permissions assigned.
/v6/securitypolicies/{id}/permissions
Retrieve Security Policy permissions for all User Groups or retrieves only Security Policies with permissions assigned atleast at one level in the hierrachy. Permissions will be retrieved in a tree representation based on the User Group hierarchy.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Security Policy Id |
|
|
Optional flag that indicates whether all the security policies to be retrieved or only the security policies with permissions assigned atleast at one level in the hierrachy to be retrieved. Set to true if only security policies with permissions assigned to be retrieved and false in case if all the security policies to be retrieved. Default value is false. |
|
|
N/A |
GET Retrieve a Security Policy
/v6/securitypolicies/{id}
Retrieve a Security Policy by security policy id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Security Policy Id |
|
|
N/A |
GET Retrieve all Security Policies
/v6/securitypolicies
Retrieve all Security Policies. Optionally only Security Policies which the user has edit permission for may be retrieved.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Sessions (5)
POST Create a Session
/v6/sessions
Create a security Session in OTMM. It returns a valid SecuritySession object if the provided credentials are valid. This is equivalent to login to OTMM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
UserName/UserId |
|
|
N/A |
POST Create/Refresh an access token
/v6/sessions/oauth2/token
Create/Refresh an access token. You need to register an OAuth client in OTDS and obtain the client Id and secret key.For more info on how to create OAuth client,refer to the OTDS documentation.Intended for server-to-server authentication.This is equivalent to login from OTMM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (6)
|
Option Name |
Description |
|---|---|
|
|
Grant Type.Allowed values are client_credentials,password,refresh_token |
|
|
Client Id |
|
|
Client Secret |
|
|
Username. Applicable only if grant_type=password |
|
|
Password Applicable only if grant_type=password |
|
|
Refresh Token. Applicable only if grant_type=refresh_token |
DELETE Delete the Session
/v6/sessions
Delete the current security Session. This is equivalent to logout from OTMM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Request otds ticket for given resource
/v6/sessions/otdssessions
Request otds ticket for given resource id. It returns a new otds ticket for corresponding resource id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Target Resource |
GET Retrieve the Session
/v6/sessions
Retrieve the current security Session.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Systemannouncements
GET Retrieve all system announcements
/v6/systemannouncements/me
Retrieve list of system announcements
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Generates new Announcments count from last login |
|
|
N/A |
Systemdetails (2)
GET Retrieve hosted help information.
/v6/systemdetails/helpURL
Retrieve hosted help information. The retrieved url is used to view the application specific hosted help information.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
The unique help id assigned to an application. For instance OTMM is assigned 'medmgtmod-h-ucw' |
|
|
The topic/context to be displayed |
|
|
The type of OT Help Content. Default value is 'ofh1'. |
|
|
N/A |
GET Retrieve the system details
/v6/systemdetails
Retrieve the system details
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Systemsettings (6)
GET Retrieve a System Setting
/v6/systemsettings/{id}
Retrieve a System Setting matching the given id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
ID of the system setting. Formed by combination of component, key and name delimited by "^^" |
|
|
N/A |
GET Retrieve all Supported Dynamic Date Ranges for retrieving data.
/v6/systemsettings/supporteddateranges
Retrieve all Supported Dynamic Date Ranges. The values retrieved are used for filtering content returned by server based on date ranges
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all Supported Dynamic Due Date Ranges for retrieving data.
/v6/systemsettings/supportedduedateranges
Retrieve all Supported Dynamic Due Date Ranges. The values retrieved are used for filtering content returned by server based on date ranges
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all Supported Locales
/v6/systemsettings/supportedlocales
Retrieve all Supported Locales. The values retrieved are derived from the SUPPORTED_LOCALES setting.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all Supported priorities for retrieving data.
/v6/systemsettings/supportedpriorities
Retrieve all Supported Priorities. The values retrieved are used for filtering content returned by server based on priorities. Priorities are typically defined on user actions.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all System Settings
/v6/systemsettings
Retrieve all System Settings
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Tasks (12)
PUT Add a comment for an Asset in a Task.
/v6/tasks/{id}/assets/{asset_id}/comments
Add a comment for the specified Asset in the Task. Only the participants of the task can perform this action.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Asset Id |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The job id |
|
|
Asset comment. |
|
|
Annotation data associated with the comment |
PATCH Add assets to task
/v6/tasks/{id}/assets
Add all the given new assets to the task.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Comma separated list of asset id's |
DELETE Delete a comment on an Asset in a Task.
/v6/tasks/{id}/assets/{asset_id}/comments
Delete a comment on the specified Asset in the Task. Only the comment creator can perform this action. Comments with an associated approval status cannot be deleted.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Asset Id |
|
|
N/A |
Options (2)
|
Option Name |
Description |
|---|---|
|
|
The job id |
|
|
The comment id |
GET Get Tasks information for current user
/v6/tasks
Get Tasks information for current user with filters.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve.If limit is set to zero then only collection summary is returned assuming that the request is made only to retrieve the counts.If limit is not passed, the default limit will be picked from the 'INBOX_RECORD_COUNT' setting. |
|
|
Filter retrieved Jobs based on the job's status. Parameter can be set to a comma separated list of status. |
|
|
Comma separated list of sort options. Sort options can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). Sorting on tasks is supported for the fields name, current_step_name, job_name, priority, due_date, end_date, start_date, status. |
|
|
Filter to retrieve Jobs based on the job's type. Parameter can be set to a comma separated list of job types. |
|
|
Flag to load job data |
|
|
Flag to load asset ids and asset count are part of tak. If set to true, will load asset details. |
|
|
Maximum number of asset ids to retrieve. This parameter is honored only when load_asset_details is set to true. If limit is not passed, the default limit will be picked from the 'ASSET_IDS_TO_LOAD_INTO_TASK' setting. |
|
|
Date Range for retrieveing tasks by creation date. Dates ranges are calculate w.r.t server time. |
|
|
Date Range for retrieving tasks by completion date. Dates ranges are calculate w.r.t server time. |
|
|
Date Ranges for retrieving tasks by due dates. Dates ranges are calculate w.r.t server time.Parameter can be set to a comma separated list of due dates. |
|
|
Retrieving tasks by end date range, starting limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving tasks by end date range, ending limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving tasks by start date range, starting limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving tasks by start date range, ending limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving tasks by due date range, starting limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Retrieving tasks by due date range, ending limit. Date format: 'yyyy-MM-dd'T'HH:mm:ss'. By default dates are calculated w.r.t server time. Server considers Dynamic date only if static date ranges are not provided |
|
|
Filter retrieved Jobs based on the job's priority. Parameter can be set to a comma separated list of priority ids. Use the 'systemsettings/supportedpriorities' resource to get the list of priorities |
|
|
N/A |
GET Retrieve a specific user task
/v6/tasks/{id}
Retrieve user task by id
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Flag to load asset ids and asset count are part of tak. If set to true, will load asset details. |
|
|
Maximum number of asset ids to retrieve. This parameter is honored only when load_asset_details is set to true. If limit is not passed, the default limit will be picked from the 'ASSET_IDS_TO_LOAD_INTO_TASK' setting. |
|
|
Flag to load the steps in the job where task is triggered from the job. If set to true, will load step. |
|
|
N/A |
GET Retrieve all Sort Options for Tasks
/v6/tasks/sortoptions
Retrieves the sort options available to sort all the tasks
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all Status Options for Tasks
/v6/tasks/statusoptions
Retrieves all supported Status Options available for retrieving Tasks.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve assets for task
/v6/tasks/{id}/assets
Retrieve assets associated with a task by task idThe fields populated in the returned object is based on the load_type parameter value. The allowable load_type values are (full,system,metadata,inherited_metadata,custom). If the load_type parameter is set to custom then you must also provide a data_load_request parameter containing the JSON representation of a DataLoadRequest object. If the load_type parameter is set to metadata or inherited_metadata then you may optionally set the metadata_to_return and/or preference_id parameters to restrict what metadata fields are retrieved. The preference_id parameter is also honored when load_type is custom
For load_type options that return metadata fields it is possible to suppress field definitions and retrieve just the values for metadata fields by specifying the request parameter level_of_detail. The allowed values are slim, or full(default)
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
Flag to load task asset summary like approval state and comment count. This flag is applicable only for review type tasks. |
|
|
N/A |
GET Retrieve task asset review comments.
/v6/tasks/{id}/assets/{asset_id}/comments
Retrieve task asset review comments for given task id and asset id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Asset Id |
|
|
N/A |
PUT Set the asset approval state for an asset in a task.
/v6/tasks/{id}/assets/{asset_id}/state
Set the asset approval state for an asset in a task.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be retrieved |
|
|
Asset Id |
|
|
N/A |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The job id |
|
|
Set asset approval state. The allowed values are 'APPROVED', 'REJECTED' and 'NONE'. |
|
|
Asset approval comment. |
PATCH Update Task Assignees
/v6/tasks/{id}/assignees
API to change the assignees of the task to other users or user group. This operation is allowed only for user who created the task.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to be assigned |
|
|
N/A |
PATCH Update a Task
/v6/tasks/{id}
Update task data for the specified Task.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Id of the task to update |
|
|
N/A |
Transferschemes (2)
POST Get Transfer Scheme session
/v6/transferschemes/{transfer_scheme}/sessions
Get Transfer session for a transfer scheme
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Name of the transfer scheme |
|
|
N/A |
GET Get Transfer Schemes
/v6/transferschemes
Get Transfer Schemes configured in the system
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Transformers
GET Retrieve transformers list
/v6/transformers
Retrieve transformers list based on the given query paramaters
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Flag to retrieve only export transformer |
|
|
Flag to retrieve only import transformer |
|
|
Flag to retrieve only export delivery transformer |
|
|
Flag to retrieve only export job transformer |
|
|
Flag to retrieve export job transformer which can be schedule |
|
|
Flag to replace transformer template values with actual values |
|
|
Retrieve export transformer associated with the content types |
|
|
N/A |
Usergroups (2)
GET Retrieve User Group(s) for a given parent group
/v6/usergroups/{id}/children
Retrieve a User Group's child group(s). This will return only user groups which are immediate children of the given parent user group.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
User Group Id |
|
|
N/A |
GET Retrieve User Group(s) for the currently logged in user
/v6/usergroups/me
Retrieve User Group(s) for the currently logged in user. Optionally comma separated list of user group ids associated with a user can be passed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
User Group Id |
|
|
N/A |
Users (6)
PATCH /v6/users/{userid}/updaterole
/v6/users/{userid}/updaterole
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
DELETE Delete all the active sessions for currently logged on User
/v6/users/me/sessions
Delete all the active sessions for currently logged on User. This operation will not delete the internal sessions associated with the user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve Users
/v6/users
Retrieve all Users with filters.Filters are case-insensitive. For those filter parameters documented as supporting wildcards below, a '*' in the parameter value will match 0 or more characters and a '?' will match exactly 1 character. If multiple filters are specified, all filters must be matched.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Filter by user's first name. This parameter supports wildcards. |
|
|
Filter by user's last name. This parameter supports wildcards. |
|
|
Filter by user's first and last name. This parameter supports wildcards. |
|
|
Filter by user's login name. This parameter supports wildcards. |
|
|
Filter by user's login id. This parameter supports wildcards. |
|
|
Filter by user's department. |
|
|
Filter by numeric representation of user's role id. |
|
|
Filter by FET id. Only users who have been granted the specified FET will be returned. |
|
|
First by user's status (active, inactive). |
|
|
First by user's email status (active, inactive). To be considered active both the email_enabled property must be set to true, and the email_address property must have a value populated. |
|
|
Property to sort the users returned by. Sort option can optionally be prepended with 'asc_' or 'desc_' to specify ascending or descending sort (default is ascending). |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
GET Retrieve a User
/v6/users/{userIdentifier}
Retrieve a User by username or userId.
For example if a user ABC is having username as abc and userId as 1234, then you can either pass abc or 1234 in place of userIdentifier to get the details of that particular user.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
UserName/UserId |
|
|
N/A |
GET Retrieve all active session info for currently logged on User
/v6/users/me/sessions
Retrieve all active session info for currently logged on User. The response of the operation does not include the internal sessions created by Media Management and the current logged in session
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve the current User
/v6/users/me
Retrieve the currently logged on User.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Usertypes (2)
GET Retrieve all User Type
/v6/usertypes
Retrieve all User Type
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
GET Retrieve all User Type
/v6/usertypes/{userTypeId}
Retrieve all User Type
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
User Type Id |
|
|
N/A |
Videos (11)
PATCH Create a Proxies
/v6/videos/proxies
Create a Proxies for the given video asset.While using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
POST Create a Sub Clip
/v6/videos/{id}/subclips
Creates a new clip for the given video asset. The ranging of the clip within and including the specified time codes for a given asset.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
N/A |
DELETE Delete video speech data for Asset Id.
/v6/videos/{id}/speech
Delete video speech data for Asset Id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
video speech text param |
|
|
N/A |
GET Get downloadable srt file.
/v6/videos/{id}/speech/srtfile
Get downloadable srt file from an video by passing the video assetId.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
User-Agent HTTP header |
|
|
Is caching enabled for this request |
|
|
N/A |
GET Retrieve insights of video asset.
/v6/videos/{id}/insights
Retrieve insights of video asset. The request needs the pagination parameters to be passed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
insightsRequestParam |
|
|
N/A |
GET Retrieve keyframes of video asset.
/v6/videos/{id}/keyframes
Retrieve keyframes of video asset. The request needs the pagination parameters to be passed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
GET Retrieve specific speech text.
/v6/videos/{id}/speech/search
Retrieve specific speech text by passing a specific string and returns speech text which contains the requested string
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
searchable string |
|
|
N/A |
GET Retrieve sub clips of video asset.
/v6/videos/{id}/subclips
Retrieve sub clips of video asset. The request needs the pagination parameters to be passed.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
Asset Id |
|
|
Data load type |
|
|
Comma separated list of metadata field ids. This parameter is ignored unless the load_type parameter is set to metadata or inherited_metadata |
|
|
Preference Id |
|
|
Filter metadata fields relevant to asset model. This parameter is honored only when metadata_to_return and/or preference_id are set in the request. |
|
|
Load multilingual values. This parameter is honored only when the load_type parameter is set to metadata or full. For the custom load type multilingual values can be requested using the load_multilingual_field_values property of the data_load_request parameter. |
|
|
JSON representation of DataLoadRequest object. This parameter is ignored unless the load_type parameter is set to custom |
|
|
Controls whether field definitions are suppressed in the metadata fields returned. |
|
|
Retrieve collection starting at the position after the specified value. If neither the after or before parameters are specified this is equivalent to after=0 and will retrieve items starting at the beginning of the collection |
|
|
Retrieve collection starting at the position before the specified value and going backwards |
|
|
Maximum number of items to retrieve. |
|
|
N/A |
PATCH Update a person's exisitng name in a video along with those who are not recognized or marked as unknown.
/v6/videos/{id}/insight/persondetails
Update a person's exisitng name in a video along with those who are not recognized or marked as unknown.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
JSON object for VideoInsightPersonParam |
|
|
N/A |
PATCH Update video speech data for Asset Id.
/v6/videos/{id}/speech
Update video speech data for Asset Id.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
assetId |
|
|
videoSpeechTextParam |
|
|
N/A |
PUT delete or un-delete of an video sub clip
/v6/videos/subclips/state
delete or un-delete of an video sub clipWhile using selection context to filter the assets based on permissions, pass permissions_filter parameter in selection context. Valid permission filters:
-
ASSETVIEW_PERM -
SUMMARYVIEW_PERM -
PREVIEWVIEW_PERM -
EXPORT_PERM -
SUBSCRIBE_PERM -
METAEDIT_PERM -
CONTENTEDIT_PERM -
MEMBERSHIPEDIT_PERM -
DELETEASSET_PERM -
EDITPARENTS_PERM -
CUSTOM01_PERM -
CUSTOM02_PERM -
CUSTOM03_PERM -
CUSTOM04_PERM
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
|
|
N/A |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Video sub clip 'state change' action; allowed values are delete, un_delete |