# Update
## Update vendor
`POST` `https://www.talque.com/webhook/org/:orgId/vendor/update`
This endpoint allows you to update vendor. Either the `extId` or the `vendorId` field must be present to identify which vendor to update. If both are present then the `extId` field of the specified vendor is updated.\
\
Apart from having to specify the ID (either internal or external), all other parameters are optional. Fields that are not included remain unchanged by the webhook call.\
\
The parameters marked with **COMING SOON:** are not yet implemented.
You can find a basic example at
#### Request Body
| Name | Type | Description |
| --------------- | -------------- | ------------------------------------------------------------------------------------------------------- |
| extId | string | External ID of the vendor to update |
| vendorId | string | Internal (talque) ID of the vendor to update. |
| name | object | Vendor name (translated text) |
| description | object | A translated text |
| customData | object | **COMING SOON:** A custom data object |
| exhibitor | string | The exhibitor category. Can be null. |
| sponsor | string | The sponsor category. Can be null. |
| businessAreas | array | The vendor filter tags |
| email | string | Company contact email address |
| phone | string | Company contact phone number |
| hall | string | Booth hall ID |
| booth | string | Booth ID |
| address | string | Company street address |
| zipCode | string | Company ZIP code |
| city | string | Company city |
| country | string | Company country: a value of country enum |
| facebook | string | Company Facebook profile URL |
| linkedin | string | Company LinkedIn profile URL |
| twitter | string | Company Twitter profile URL |
| xing | string | Company Xing profile URL |
| instagram | string | Company Instagram URL |
| website | string | Company website URL |
| photo | string \| null | A temp file ID, or null to delete |
| backgroundImage | string \| null | A temp file ID, or null to delete |
| staff | string\[] | Company staff members as a [list of profile ids](/public/webhooks/users.md) (existing profile required) |
| staffPending | string\[] | Company staff members that have not joined yet as a [list of account ids](/public/webhooks/users.md) |
| admins | string\[] | A [list of account ids](/public/webhooks/users.md) of admins |
| isSelfSelect | boolean | **COMING SOON:** A boolean value |
| staffCanMeet | boolean | **COMING SOON:** A boolean value |
| staffCanChat | boolean | **COMING SOON:** A boolean value |
| locale | string | A value of locale enum, see the [supported values](/public/json-api/general/locales-and-text.md) |
| video | object | A translated text object with the video URLs |
| gallery | object | A gallery change object |
| clearGallery | boolean | Whether to delete all gallery objects that are not referenced |
| portfolio | object | A portfolio change object |
| clearPortfolio | boolean | Whether to delete all portfolio objects that are not referenced |
| marks | string\[] | A list of vendor tags |
| perks | string\[] | A list of perk ids |
| main | string\[] | A list of vendor IDs |
| adminName | object | A translated text for an internal (admin-only) name for the vendor |
| buttons | array | Array of `{url, label}` objects for custom buttons to display on the company profile |
{% tabs %}
{% tab title="200 Vendor successfully updated" %}
```javascript
{
"reasonEnum": "UpdateVendorReason",
"reason": "SUCCESS",
"vendor": {
"rating": null,
"photoMedium": "/_ah/img/encoded_gs_file:cGhvdG8udGFscXVlLmNvbS92ZW5kb3IvY2NDOFFGTklPakhCRUI5YUczZ0ovMTYyNzMyMTEzNC5qcGc=",
"instagram": "https://instagram.com/foo",
"vendorId": "ccC8QFNIOjHBEB9aG3gJ",
"isVipSpot": false,
"photo": "/_ah/img/encoded_gs_file:cGhvdG8udGFscXVlLmNvbS92ZW5kb3IvY2NDOFFGTklPakhCRUI5YUczZ0ovMTYyNzMyMTEzNC5qcGc=",
"twitter": "https://twitter/foo",
"descriptionSource": {
"DE_DE": "German new",
"EN_US": "English new"
},
"linkedin": "https://linkedin/foo",
"isPublished": true,
"vipAnswerRequired": false,
"video": null,
"booth": "3",
"mtime": 1627321434073,
"portfolio": {
"items": [],
"config": {
"document": 0,
"limit": 0
}
},
"staff": [
"IsPclKMCQ95K51qDk192",
"RyKgC5yP5OLLoiWPILMy"
],
"city": "Newcity",
"xing": "https://xing.de/foo",
"name": "Newname",
"vipQuestionSource": {},
"admins": [
"RPUDoQPRShPX5QgOpeiH"
],
"hall": "8",
"buttons": [],
"locale": "EN_US",
"subjects": [],
"backgroundImage": null,
"marks": [],
"vipCategories": [],
"main": [],
"email": "vendor@debug.foo",
"vipSpots": [],
"businessAreas": [],
"website": "https://new.debug.foo/bar/baz.html",
"isInLeadList": false,
"vendor": "exhib",
"description": "",
"form": {
"instagram": null,
"photo": null,
"twitter": null,
"descriptionSource": {},
"linkedin": null,
"mtime": 0,
"city": null,
"xing": null,
"backgroundImage": null,
"editor": null,
"email": null,
"website": "",
"citySource": {},
"description": null,
"zipCode": null,
"phone": null,
"facebook": null,
"address": null,
"name": null,
"country": "",
"countrySource": null,
"nameSource": {}
},
"portfolioSource": {
"items": [],
"config": {
"document": 0,
"limit": 0
}
},
"customData": {
"data": [
{
"type": "StringData",
"id": "iNzycByOV1bulbPt41kE",
"value": "Bamberg"
},
{
"vendorId": "K1F4CbMn49B3xJ1I3I3B",
"filename": "logo.eps",
"previewUrl": "http://path/to/preview.jpg",
"fileId": "YdvGQQr7nzq20b7jYVbM",
"type": "VendorFileData",
"id": "rZQCVQRxx2XUrq05ZCbs",
"tempFileId": null
},
{
"type": "IntegerData",
"id": "EjbS2j0lB4Rhikfptaxk",
"value": 99
}
]
},
"quota": {
"speakerFormCredits": 1,
"directCall": false,
"products": [],
"dashboard": false,
"markLimits": [],
"leadList": {
"profile": false,
"portfolio": false,
"gallery": false,
"chat": false
}
},
"zipCode": "54321",
"phone": "555 555-5555",
"facebook": "https://facebook/foo",
"staffCanMeet": true,
"vipQuestion": null,
"address": "Newstr 20",
"gallery": {
"items": [],
"config": {
"limit": 0,
"embed": 0,
"video": 0,
"image": 0
}
},
"needsApproval": false,
"isSelfSelect": true,
"hasVipSpot": false,
"ctime": 1627321134073,
"country": "United States",
"staffCanChat": true,
"speakerFormCredits": 1,
"citySource": {
"EN_US": "Newcity"
},
"isSpeakerFormInvitationSent": false,
"ownRating": 42,
"extId": null,
"countrySource": "US",
"perks": [],
"isFormInvitationSent": false,
"nameSource": {
"EN_US": "Newname"
},
"isLectureFormInvitationSent": false,
"sponsor": "gold"
},
"channel": {
"notification": null,
"messages": [
{
"data": {
"orgId": "Y52ccThbN4RjsTLljTu5",
"vendorIdList": [
"ccC8QFNIOjHBEB9aG3gJ"
]
},
"messageType": "VENDOR_CHANGE"
}
],
"sender": {
"sessionId": "ZjJD06EBHyZYdT9sYsBy",
"accountId": "lhSAV55zl23Wr07aWDmh"
},
"sortKey": "1wD9B8k8iOQ",
"time": 1627321134269
},
"success": true
}
```
{% endtab %}
{% endtabs %}
### Example Request
```javascript
{
"address": "Newstr 20",
"admins": [
"RPUDoQPRShPX5QgOpeiH"
],
"booth": "3",
"city": {
"EN_US": "Newcity"
},
"country": "US",
"description": {
"DE_DE": "German new",
"EN_US": "English new"
},
"email": "vendor@debug.foo",
"facebook": "https://facebook/foo",
"hall": "8",
"instagram": "https://instagram.com/foo",
"linkedin": "https://linkedin/foo",
"name": {
"EN_US": "Newname"
},
"phone": "555 555-5555",
"photo": "MiuWhICsJxcCOiSsVTJL",
"sponsor": "gold",
"twitter": "https://twitter/foo",
"vendor": "exhib",
"vendorId": "ccC8QFNIOjHBEB9aG3gJ",
"website": "https://new.debug.foo/bar/baz.html",
"xing": "https://xing.de/foo",
"zipCode": "54321"
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://talque.gitbook.io/public/webhooks/vendors/update.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.