Update Address
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/address';const options = { method: 'PATCH', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"address1":"234 Near da beach","address2":"Pebble #5001","city":"Bangkok","country":"United States","countryCode":"TH","county":"Alameda county","fullAddress":"11 At home, Suite 3C, New York City, NY 10010, United States","postalCode":"90210","state":"CA"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/address \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "address1": "234 Near da beach", "address2": "Pebble #5001", "city": "Bangkok", "country": "United States", "countryCode": "TH", "county": "Alameda county", "fullAddress": "11 At home, Suite 3C, New York City, NY 10010, United States", "postalCode": "90210", "state": "CA" }'Updates managing entity address. Supports optimistic concurrency via the If-Match header; a stale version is rejected with 409.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”UUID of the managing entity whose address to update.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”The managing entity’s last-seen version, for optimistic concurrency. Optional; when present a stale value is rejected with 409. Accepts a bare version (3), a quoted entity-tag (“3”), W/“3”, or *.
Request Bodyrequired
Section titled “Request Bodyrequired”New address to associate with the managing entity
Address information
object
Address line 1
Example
234 Near da beachAddress line 2
Example
Pebble #5001City name
Example
BangkokCountry
Example
United StatesCountry
Example
THCounty
Example
Alameda countyAddress 1, Address 2, City, State, Postal / Zip code, Country
Example
11 At home, Suite 3C, New York City, NY 10010, United StatesPostal / zip code
Example
90210State
Example
CAExample
{ "address1": "234 Near da beach", "address2": "Pebble #5001", "city": "Bangkok", "country": "United States", "countryCode": "TH", "county": "Alameda county", "fullAddress": "11 At home, Suite 3C, New York City, NY 10010, United States", "postalCode": "90210", "state": "CA"}Responses
Section titled “Responses”Managing entity updated with the new address.
Lightweight projection of a managing entity, used by consumers outside the managing-entity module.
object
Primary email address for account communications, KYC documents, and compliance notices.
Primary phone number for KYC verification and account support.
A sub-account of a managing entity, representing one of its functional roles (affiliate, property, or payment).
object
Entity ID should be the same as parent but can be different.
Type of entity (e.g. PROPERTY, AFFILIATE, PAYMENT).
Account address. Usually the business address.
object
Address line 1
Address line 2
City name
Country
Country
County
Address 1, Address 2, City, State, Postal / Zip code, Country
Postal / zip code
State
Bank accounts used for payouts.
object
Name of the bank account holder.
Bank account number or IBAN. In all EU countries, this is the IBAN; in other countries, the routing number also applies.
Recipient bank account address. Optional; recommended by Revolut and required by some payout corridors.
object
Address line 1
Address line 2
City name
Country
Country
County
Address 1, Address 2, City, State, Postal / Zip code, Country
Postal / zip code
State
ISO 3166-1 alpha-2 country code (e.g. US, GB, TH, JP).
ISO 4217 currency code (e.g. USD, EUR, THB).
Unique bank account identifier
Revolut counterparty ID assigned after the first successful payout is initiated. Null until first Revolut payout.
Bank account routing number (US), sort code (UK/HK), or Zengin code (JP).
Bank SWIFT code (BIC), uniquely identifying the bank and branch.
City location.
object
Ascii name of city
Country
object
Country capital
Continent code
Currency code
Currency name
Country GeoNames identifier
ISO code
Country name
ISO 3166-1 alpha-2 country code for the country this location belongs to
GeoNames specific feature code identifying the place type (e.g. PPL=populated place, PPLC=national capital, ISL=island)
GeoName identifier
Coordinate points of the city
object
Name of city
Country sub division
object
Sub-country ascii name
Sub-country GeoNames identifier
Sub-country name
Country sub sub division
object
ASCII-transliterated name of the county or district, safe for URLs and sorting
GeoNames.org unique identifier for this subdivision
Official name of the county or district in its local script
IANA timezone identifier for the location
GeoNameLightweight type
Url name
Datetime this record was first created
ISO 4217 primary currency code for accounting and payouts.
Short description reflecting the entity’s brand and positioning.
Unique identifier for this record.
Datetime this record was last updated
Legal/registered name if different from display name.
Entity logo.
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
Longer text description
Indicate which language this description is written in.
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.
If another company entity is managing this property on behalf of it, specified here.
object
Agency commission
Entity identifier
Name of entity
Optional rules for expiration date etc when agency is no longer managing this entity.
Users who can manage this entity and all sub-entities.
object
Email address of the managing entity team member.
First name of the team member.
Last name of the team member.
Account owner
Phone number for contacting the team member.
Profile picture is available
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
Longer text description
Indicate which language this description is written in.
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.
Secondary/alternative email address for the team member.
Per-section access grants for object-level ACL
object
Access level (READ < WRITE < FULL); a higher level subsumes all lower ones
Functional area of the platform this grant applies to; ALL is a wildcard that covers every section
Invitation status: PENDING (invite sent, awaiting response), ACCEPTED (active team member).
Unique identifier of the associated user (null until invitation is accepted).
Whether the managing entity has consented to have their logo and images used for Wink marketing.
Display name of the managing entity.
Online presence of account.
object
The size of your audience.
Whether to disable this entry temporarily.
The url, account name or phone number that identifies this user with the specified network.
How you would like to order your accounts.
List of all active accounts that could be used for selling or seeing a company’s reach.
A team member of a managing entity account, with their invitation/activation status, contact details, and per-section access grants.
object
Email address of the managing entity team member.
First name of the team member.
Last name of the team member.
Account owner
Phone number for contacting the team member.
Profile picture is available
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
Longer text description
Indicate which language this description is written in.
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.
Secondary/alternative email address for the team member.
Per-section access grants for object-level ACL
object
Access level (READ < WRITE < FULL); a higher level subsumes all lower ones
Functional area of the platform this grant applies to; ALL is a wildcard that covers every section
Invitation status: PENDING (invite sent, awaiting response), ACCEPTED (active team member).
Unique identifier of the associated user (null until invitation is accepted).
UUID of the application/owner that provisioned this record (typically Wink).
Owner type: INDIVIDUAL (sole proprietor) or COMPANY (corporate entity).
Optional Google placeId for properties with a Google Business account.
Custom profile picture.
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
Longer text description
Indicate which language this description is written in.
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.
Revolut revtag payout destinations.
object
Full legal name of the Revolut account holder (must match the Revolut profile name exactly).
ISO 4217 currency code for payouts to this account (e.g. EUR, USD, GBP).
Unique identifier for this payout destination.
Revolut profile type: PERSONAL (individual account) or BUSINESS (business/enterprise account).
Cached Revolut counterparty ID (assigned after first successful payout). Null only during initial creation before counterparty is established.
Revolut username/tag (without the leading ‘@’ symbol).
Status of entity.
Travel agent details.
object
Whether the agent is in charge of charging the property.
Whether the agent is in charge of paying the property.
Entity type: HOTEL, APPLICATION, TRAVEL_AGENT, INFLUENCER, CORPORATE, DESTINATION, CHANNEL_MANAGER, etc.
Human-friendly unique identifier (shorter than UUID, used in some public contexts).
Primary website or social media URL representing the entity.
URL-friendly slug (kebab-case) uniquely identifying the entity in public profiles and links.
UUID of the user who created/owns this managing entity.
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
{ "currencyCode": "THB", "id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "name": "The Siam Residences, Bangkok", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "ownerType": "COMPANY", "status": "ACTIVE", "type": "HOTEL", "uniqueId": "siam-residences-bkk", "urlName": "the-siam-residences-bangkok", "userIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69"}Bad Request — missing or invalid request parameter or body
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unauthorized — authentication is required or the session has expired
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Forbidden — authenticated but lacking the required permission or scope
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Not Found — the requested resource does not exist
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unsupported Media Type — use application/json
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Internal Server Error — an unexpected failure occurred on the server
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Service Unavailable — a downstream dependency is unreachable
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}