setUrlModifier

Sets the Image Serving or Image Rendering protocol commands for the specified asset. These commands modify the representation of the asset without destroying it.

For Image Serving, commands in the urlModifier parameter are published in the Modifier catalog field and applied prior to any commands specified on the request URL. Commands in urlPostApplyModifier will be published to the PostModifier catalog field and will override any commands on the request URL or in urlModifier. For Image Rendering, the commands in urlModifier and urlPostApplyModifier are concatenated and published to the Modifier catalog field.

Authorized User Types

IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

Parameters

Input (setUrlModifierParam)

Name	Type	Required	Description
``companyHandle``	`xsd:string`	Yes	Company handle.
``assetHandle``	`xsd:string`	Yes	Asset handle.
``urlModifier``	`xsd:string`	No	Image Serving or Image Rendering protocol commands to apply prior to request or `urlPostApplyModifier` commands.
``urlPostApplyModifier``	`xsd:string`	No	Image Serving or Image Rendering protocol commands to apply after `urlModifier` and request commands.

Output (setUrlModifierReturn)

The IPS API does not return a response for this operation.

Examples

Request

<setUrlModifierParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <assetHandle>a|942|1|579</assetHandle>
   <urlModifier>modify=that</urlModifier>
   <urlPostApplyModifier>action=awesomeToo</urlPostApplyModifier>
</setUrlModifierParam>

Response

None.

Resources on adobe.com

Multichannel Communication Auto Form Fill Customer Communications Personalized Communications Content As A Service Digital Rights Management

View next:

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free