Update
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/wink-links/shortened-url/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51';const options = { method: 'PUT', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/wink-links/shortened-url/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullEdits an existing shortened URL’s slug and target by its identifier.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Managing entity identifier that owns the shortened URL
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Identifier of the shortened URL to update
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Updated shortened URL details (title, slug, target, metadata)
Request payload for creating or updating a shortened URL entry
object
Open Graph audio media extracted from the target URL
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Example
The Siam Residences exterior viewMedia height in pixels
Example
630HTTPS URL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
Example
image/jpegURL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMedia width in pixels
Example
1200Example
{ "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200"}Localized descriptions of the shortened URL entry
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Example
SYSTEMLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eUse as title or short text description
Example
An example titleExample
{ "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite"}Entity identifier that the uniqueId originates from. Omit for type=URL, required for other types.
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Open Graph images extracted from the target URL
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Example
The Siam Residences exterior viewMedia height in pixels
Example
630HTTPS URL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
Example
image/jpegURL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMedia width in pixels
Example
1200Example
{ "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200"}Extended metadata key-value pairs (e.g., seo keywords, tags)
object
Primary media assets associated with this shortened URL
Multimedia that contains less information than Multimedia object
object
Media angle
Example
-90Whether image has attribution properties
object
Name of contributor
Example
Samuel AdamsURL to contributor
Example
https://maps.google.com/maps/contrib/111628493169070103594Example
{ "name": "Samuel Adams", "url": "https://maps.google.com/maps/contrib/111628493169070103594"}Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Example
SYSTEMLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eUse as title or short text description
Example
An example titleExample
{ "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite"}Media height in pixels.
Example
1600Use this identifier to communicate with Cloudinary.
Example
cloudinary-image-1True if media width is greater or equal to height
Example
trueAssociate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Example
LIFESTYLE_HEALTH_FITNESSDocument identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Example
trueSort allows you to control how you want to sort this record in a list of media records.
Example
10Currently ONLY using Cloudinary to store all image / video assets.
Example
CLOUDINARYWhether Cloudinary media is a VIDEO or IMAGE.
Example
IMAGEMedia width in pixels.
Example
2560Example
{ "angle": null, "attribution": [], "category": "2", "descriptions": [ { "description": "Elegant lobby of The Siam Residences", "language": "en", "title": "Lobby Entrance" } ], "height": 1600, "identifier": "the-siam-residences/lobby-entrance", "isLandscape": true, "lifestyleType": null, "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "published": true, "sort": 10, "source": "CLOUDINARY", "type": "IMAGE", "width": 2560}Display name for this shortened URL
Example
The Siam Residences, BangkokType of entity the uniqueId links to (URL, PROPERTY, BOOKING, etc.)
Example
URLURL-friendly slug that uniquely identifies this entry within the owner’s account
Example
the-siam-residences-promoTarget URL to redirect to. Required when type=URL, omit for other types.
Example
https://www.thesiamresidences.com/luxury-stayOpen Graph videos extracted from the target URL
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Example
The Siam Residences exterior viewMedia height in pixels
Example
630HTTPS URL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
Example
image/jpegURL of the media asset
Example
https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpgMedia width in pixels
Example
1200Example
{ "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200"}Example
{ "audioList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ], "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "entityId": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "imageList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ], "multimedias": [ { "angle": null, "attribution": [], "category": "2", "descriptions": [ { "description": "Elegant lobby of The Siam Residences", "language": "en", "title": "Lobby Entrance" } ], "height": 1600, "identifier": "the-siam-residences/lobby-entrance", "isLandscape": true, "lifestyleType": null, "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "published": true, "sort": 10, "source": "CLOUDINARY", "type": "IMAGE", "width": 2560 } ], "title": "The Siam Residences, Bangkok", "type": "URL", "uniqueId": "the-siam-residences-promo", "url": "https://www.thesiamresidences.com/luxury-stay", "videoList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ]}Responses
Section titled “Responses”The shortened URL after applying the requested changes
Lightweight, read-only projection of a shortened URL, used by cross-domain consumers.
object
Open Graph audio media extracted from the target URL.
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Media height in pixels
HTTPS URL of the media asset
MIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
URL of the media asset
Media width in pixels
Datetime this record was first created
Localized descriptions of the shortened URL entry.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Entity identifier that the uniqueId originates from. Empty for type=URL.
Unique identifier for this record.
Open Graph images extracted from the target URL.
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Media height in pixels
HTTPS URL of the media asset
MIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
URL of the media asset
Media width in pixels
Datetime this record was last updated
Extended metadata key-value pairs (e.g., seo keywords, tags).
object
Primary media assets associated with this shortened URL.
Multimedia that contains less information than Multimedia object
object
Media angle
Whether image has attribution properties
object
Name of contributor
URL to contributor
Supported OTA specification PIC code. See OTA geoname data
Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Media height in pixels.
Use this identifier to communicate with Cloudinary.
True if media width is greater or equal to height
Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Document identifier
Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Sort allows you to control how you want to sort this record in a list of media records.
Currently ONLY using Cloudinary to store all image / video assets.
Whether Cloudinary media is a VIDEO or IMAGE.
Media width in pixels.
Managing entity / owner identifier that owns this shortened URL.
Previous URL slugs maintained for SEO and backward compatibility.
Display name of the shortened URL.
Type of entity the uniqueId links to (URL, PROPERTY, BOOKING, etc.).
URL-friendly slug that uniquely identifies this entry within the owner’s account.
Target URL to redirect to. Required when type=URL, omitted for other types.
Creator of this shortened URL.
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Open Graph videos extracted from the target URL.
Open Graph media asset (image, video, or audio)
object
Alternative text description for accessibility
Media height in pixels
HTTPS URL of the media asset
MIME type of the media (image/jpeg, video/mp4, audio/mpeg, etc.)
URL of the media asset
Media width in pixels
Example
{ "audioList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ], "createdDate": "2026-01-14T09:30:00", "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "imageList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ], "lastUpdate": "2026-02-03T16:45:12", "multimedias": [ { "angle": null, "attribution": [], "category": "2", "descriptions": [ { "description": "Elegant lobby of The Siam Residences", "language": "en", "title": "Lobby Entrance" } ], "height": 1600, "identifier": "the-siam-residences/lobby-entrance", "isLandscape": true, "lifestyleType": null, "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "published": true, "sort": 10, "source": "CLOUDINARY", "type": "IMAGE", "width": 2560 } ], "version": 3, "videoList": [ { "alt": "The Siam Residences exterior view", "height": "630", "secureUrl": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "type": "image/jpeg", "url": "https://res.cloudinary.com/traveliko/image/upload/v1689655191/the-siam-residences-bangkok.jpg", "width": "1200" } ]}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable
