Upsert
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/wink-links/syndication/settings';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/syndication/settings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullCreate or replace the account’s WinkLinks syndication settings.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Update settings for this managing entity identifier.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”WinkLinks settings to create or update
Request payload for creating or updating the display and layout settings for a WinkLinks profile page.
object
Account name heading size
Example
LGCustomization identifier for this WinkLinks account
Example
b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47Desktop background image
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}Desktop gradient angle in degrees (0-360)
Example
180Whether the desktop gradient background is enabled
Example
falseDesktop gradient type
Example
LINEARDesktop background pattern type
Example
GRIDCustom font for account name display
Example
UI_SANS_SERIFWhether to treat all links as flat web links or try to embed more advanced data.
Example
Embedding a tweetWhich way to display the list when WinkLinks first loads
Example
LISTMobile background image
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}Mobile gradient angle in degrees (0-360)
Example
180Whether the mobile gradient background is enabled
Example
falseMobile gradient type
Example
LINEARMobile background pattern type
Example
GRIDWhere to show the online presence icons
Example
BOTTOMControls how to display profile picture
Example
CIRCLEProfile picture size for circle and rectangle geometries
Example
MDCustomizable QR code options
object
Corner square gradient color
Example
#FFFFFFCorners square gradient rotation
Example
5Corners square gradient
Example
LINEARCorner square type
Example
0Corner square primary color
Example
#000000Corner dot gradient color
Example
#FFFFFFCorners dot gradient rotation
Example
5Corners dot gradient
Example
LINEARCorner dot primary color
Example
#000000Corner dot type
Example
SQUARECorner square gradient color
Example
#FFFFFFCorners square gradient rotation
Example
5Corners square gradient
Example
LINEARCorner square primary color
Example
#000000Corner square type
Example
SQUAREDots gradient color
Example
#FFFFFFDots gradient rotation
Example
5Dots gradient
Example
LINEARDots round size
Example
trueDots primary color
Example
#000000QR code shape
Example
SQUARECustom image ID for subscribers
Example
abc123QR code shape
Example
CIRCLEExample
{ "backgroundEndColor": "#FFFFFF", "backgroundGradientRotation": 5, "backgroundGradientType": "LINEAR", "backgroundRound": 0, "backgroundStartColor": "#000000", "cornerDotEndColor": "#FFFFFF", "cornerDotGradientRotation": 5, "cornerDotGradientType": "LINEAR", "cornerDotStartColor": "#000000", "cornerDotType": "SQUARE", "cornerSquareEndColor": "#FFFFFF", "cornerSquareGradientRotation": 5, "cornerSquareGradientType": "LINEAR", "cornerSquareStartColor": "#000000", "cornerSquareType": "SQUARE", "dotsEndColor": "#FFFFFF", "dotsGradientRotation": 5, "dotsGradientType": "LINEAR", "dotsRoundSize": true, "dotsStartColor": "#000000", "dotsType": "SQUARE", "imageIdentifier": "abc123", "shape": "CIRCLE"}Theme colors are connected with the primary account customization.
object
Body color
Example
#212529Danger color
Example
#dc3545Dark color
Example
#343a40Info color
Example
#17a2b8Light color
Example
#f8f9faMuted color
Example
#6c757dPrimary color
Example
#dc3545Secondary color
Example
#6c757dSuccess color
Example
#28a745Warning color
Example
#ffc107White color
Example
#ffffffExample
{ "body": "#212529", "danger": "#dc3545", "dark": "#343a40", "info": "#17a2b8", "light": "#f8f9fa", "muted": "#6c757d", "primary": "#dc3545", "secondary": "#6c757d", "success": "#28a745", "warning": "#ffc107", "white": "#ffffff"}Example
{ "accountNameSize": "LG", "customizationIdentifier": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "desktopBackgroundImage": { "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 }, "desktopGradientAngle": 180, "desktopGradientEnabled": false, "desktopGradientType": "LINEAR", "desktopPattern": "GRID", "fontId": "UI_SANS_SERIF", "itemDisplay": "Embedding a tweet", "layoutDisplay": "LIST", "mobileBackgroundImage": { "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 }, "mobileGradientAngle": 180, "mobileGradientEnabled": false, "mobileGradientType": "LINEAR", "mobilePattern": "GRID", "onlinePresencePosition": "BOTTOM", "profilePictureGeometry": "CIRCLE", "profilePictureSize": "MD", "qrCodeOptions": { "backgroundEndColor": "#FFFFFF", "backgroundGradientRotation": 5, "backgroundGradientType": "LINEAR", "backgroundRound": 0, "backgroundStartColor": "#000000", "cornerDotEndColor": "#FFFFFF", "cornerDotGradientRotation": 5, "cornerDotGradientType": "LINEAR", "cornerDotStartColor": "#000000", "cornerDotType": "SQUARE", "cornerSquareEndColor": "#FFFFFF", "cornerSquareGradientRotation": 5, "cornerSquareGradientType": "LINEAR", "cornerSquareStartColor": "#000000", "cornerSquareType": "SQUARE", "dotsEndColor": "#FFFFFF", "dotsGradientRotation": 5, "dotsGradientType": "LINEAR", "dotsRoundSize": true, "dotsStartColor": "#000000", "dotsType": "SQUARE", "imageIdentifier": "abc123", "shape": "CIRCLE" }, "themeColors": { "body": "#212529", "danger": "#dc3545", "dark": "#343a40", "info": "#17a2b8", "light": "#f8f9fa", "muted": "#6c757d", "primary": "#dc3545", "secondary": "#6c757d", "success": "#28a745", "warning": "#ffc107", "white": "#ffffff" }}Responses
Section titled “Responses”Syndication settings saved and returned with resolved theme colors
WinkLinks display settings enriched with the resolved theme colors from the account’s active customization, used when rendering the public profile page.
object
Account name heading size
Datetime this record was first created
Customization identifier
Desktop background image
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.
Desktop gradient angle in degrees (0-360)
Whether the desktop gradient background is enabled
Desktop gradient type
Desktop background pattern type
Custom font for account name display
Unique identifier for this record.
Whether to treat all links as flat web links or try to embed more advanced data.
Datetime this record was last updated
Which way to itemDisplay the list when WinkLinks first loads
Mobile background image
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.
Mobile gradient angle in degrees (0-360)
Whether the mobile gradient background is enabled
Mobile gradient type
Mobile background pattern type
Where to show the online presence icons
The user’s owner company this entry associates with
Controls how to itemDisplay profile picture
Profile picture size for circle and rectangle geometries
Customizable QR code options
object
Corner square gradient color
Corners square gradient rotation
Corners square gradient
Corner square type
Corner square primary color
Corner dot gradient color
Corners dot gradient rotation
Corners dot gradient
Corner dot primary color
Corner dot type
Corner square gradient color
Corners square gradient rotation
Corners square gradient
Corner square primary color
Corner square type
Dots gradient color
Dots gradient rotation
Dots gradient
Dots round size
Dots primary color
QR code shape
Custom image ID for subscribers
QR code shape
Theme colors are connected with the primary account customization.
object
Body color
Danger color
Dark color
Info color
Light color
Muted color
Primary color
Secondary color
Success color
Warning color
White color
Creator of entry
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.
Example
{ "accountNameSize": "LG", "createdDate": "2026-01-14T09:30:00", "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "desktopBackgroundImage": null, "desktopGradientAngle": 180, "desktopGradientEnabled": false, "desktopGradientType": "LINEAR", "desktopPattern": "GRID", "fontId": "UI_SANS_SERIF", "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "itemDisplay": "FROM_LAYOUT", "lastUpdate": "2026-02-03T16:45:12", "layoutDisplay": "GRID_COLUMNS", "mobileBackgroundImage": null, "mobileGradientAngle": 180, "mobileGradientEnabled": false, "mobileGradientType": "LINEAR", "mobilePattern": "GRID", "onlinePresencePosition": "TOP", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "profilePictureGeometry": "CIRCLE", "profilePictureSize": "MD", "qrCodeOptions": { "backgroundEndColor": "#F8F9FA", "backgroundGradientRotation": 0, "backgroundGradientType": "LINEAR", "backgroundRound": 0, "backgroundStartColor": "#FFFFFF", "cornerDotEndColor": "#FFFFFF", "cornerDotGradientRotation": 0, "cornerDotGradientType": "LINEAR", "cornerDotStartColor": "#000000", "cornerDotType": "SQUARE", "cornerSquareEndColor": "#FFFFFF", "cornerSquareGradientRotation": 0, "cornerSquareGradientType": "LINEAR", "cornerSquareStartColor": "#000000", "cornerSquareType": "SQUARE", "dotsEndColor": "#FFFFFF", "dotsGradientRotation": 0, "dotsGradientType": "LINEAR", "dotsRoundSize": true, "dotsStartColor": "#000000", "dotsType": "SQUARE", "imageIdentifier": "abc123", "shape": "SQUARE" }, "themeColors": { "body": "#212529", "danger": "#dc3545", "dark": "#343a40", "info": "#17a2b8", "light": "#f8f9fa", "muted": "#6c757d", "primary": "#dc3545", "secondary": "#6c757d", "success": "#28a745", "warning": "#ffc107", "white": "#FFFFFF" }, "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84"}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