Update Smart Link Asset API (Beta)

📘
This API is currently available only for clients hosted in the AWS-USA data centre.

This API is used to update the details of a link by id.

📘
Based on the domain that is assigned, the endpoint domain for your API varies. For more information, refer to the Know Your API Endpoints section.

Headers

The following table describes the request headers:

Request Header	Description
content-Type	application/json
Authorization	Access token in Bearer format Example: Bearer $(key)

Body Parameters

Parameter	Type	Mandatory	Description
longUrl	String	Yes	Specifies the long URL.
domains	String	Yes	Specifies the domain name in which the smart link was created.
deviceRouting	String	Yes	Specifies the OS specific URLs. androidUrl: Returns the Android specific URL. "iosUrl: Specifies the iOS specific URL. * "windowsUrl Specifies the Windows specific URL.
redirectParam	String	No	Specifies the redirect parameter. The default value is redirect.
encAlgo	String	Yes	Specifies the encryption algorithm.
encPassKey	String	Yes	Specifies the encryption passkey.
expiresOn	String	Yes	Specifies the date till which the link is valid.
expiryUrl	String	Yes	Specifies the redirect URL on link expiry.
urlContext	String	Yes	Specifies the context parameters that are used for personalization.
referenceId	String	Yes	Specifies the referenceid of the smart link.

Request Example


{
  "longUrl": "https://touchstone1.webexcampaign.io/nextgen",
  "domain": "ciscowebexcampaign6.com",
  "deviceRouting": {
    "androidUrl": "https://touchstone1-android.webexcampaign.io/nextgen",
    "iosUrl": "https://touchstone1-ios.webexcampaign.io/nextgen",
    "windowsUrl": "https://touchstone1-windows.webexcampaign.io/nextgen"
  },
  "redirectParam": "redirect",
  "encAlgo": "AES",
  "encPassKey": "testingtest@1234",
  "expiresOn": "2023-10-08T07:44:51.000Z",
  "expiryUrl": "https://touchstone1.webexcampaign.io/expired",
  "urlContext": {
    "msisdn": "123456789"
  },
  "referenceId": "6391b6da5481373783e33952"
}

Response Example

{
    "code": "1006",
    "message": "SmartLinks Asset Details Updated Successfully."
}

Response Parameters

This API will return the following response parameters:

Code	Description
code	Returns the response code.
message	Returns the confirmation message.

Failure Response Codes

The API will return a code within the response as per the following table in case of failure scenarios.

HTTP Status Code	Code within API Response	Description
400	NA	Bad request
401	NA	Invalid token or Access token expired
404	NA	No Entity exists with the given Id.
405	NA	Method not supported
500	NA	Internal server error.