Xojo / Support API / Update a Brand
Back to Collection Items
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
Dim http As New Chilkat.Http
Dim success As Boolean
http.BasicAuth = True
http.Login = "login"
http.Password = "password"
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "brand": {
// "name": "<string>",
// "subdomain": "<string>",
// "active": "<boolean>",
// "brand_url": "<string>",
// "created_at": "<dateTime>",
// "default": "<boolean>",
// "has_help_center": "<boolean>",
// "help_center_state": "enabled",
// "host_mapping": "<string>",
// "id": "<integer>",
// "is_deleted": "<boolean>",
// "logo": {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>",
// "thumbnails": [
// {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>"
// },
// {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>"
// }
// ]
// },
// "signature_template": "<string>",
// "ticket_form_ids": "<array>",
// "updated_at": "<dateTime>",
// "url": "<string>"
// }
// }
Dim json As New Chilkat.JsonObject
success = json.UpdateString("brand.name","<string>")
success = json.UpdateString("brand.subdomain","<string>")
success = json.UpdateString("brand.active","<boolean>")
success = json.UpdateString("brand.brand_url","<string>")
success = json.UpdateString("brand.created_at","<dateTime>")
success = json.UpdateString("brand.default","<boolean>")
success = json.UpdateString("brand.has_help_center","<boolean>")
success = json.UpdateString("brand.help_center_state","enabled")
success = json.UpdateString("brand.host_mapping","<string>")
success = json.UpdateString("brand.id","<integer>")
success = json.UpdateString("brand.is_deleted","<boolean>")
success = json.UpdateString("brand.logo.content_type","<string>")
success = json.UpdateString("brand.logo.content_url","<string>")
success = json.UpdateString("brand.logo.deleted","<boolean>")
success = json.UpdateString("brand.logo.file_name","<string>")
success = json.UpdateString("brand.logo.height","<string>")
success = json.UpdateString("brand.logo.id","<integer>")
success = json.UpdateString("brand.logo.inline","<boolean>")
success = json.UpdateString("brand.logo.malware_access_override","<boolean>")
success = json.UpdateString("brand.logo.malware_scan_result","<string>")
success = json.UpdateString("brand.logo.mapped_content_url","<string>")
success = json.UpdateString("brand.logo.size","<integer>")
success = json.UpdateString("brand.logo.url","<string>")
success = json.UpdateString("brand.logo.width","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].content_type","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].content_url","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].deleted","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[0].file_name","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].height","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].id","<integer>")
success = json.UpdateString("brand.logo.thumbnails[0].inline","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[0].malware_access_override","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[0].malware_scan_result","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].mapped_content_url","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].size","<integer>")
success = json.UpdateString("brand.logo.thumbnails[0].url","<string>")
success = json.UpdateString("brand.logo.thumbnails[0].width","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].content_type","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].content_url","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].deleted","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[1].file_name","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].height","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].id","<integer>")
success = json.UpdateString("brand.logo.thumbnails[1].inline","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[1].malware_access_override","<boolean>")
success = json.UpdateString("brand.logo.thumbnails[1].malware_scan_result","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].mapped_content_url","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].size","<integer>")
success = json.UpdateString("brand.logo.thumbnails[1].url","<string>")
success = json.UpdateString("brand.logo.thumbnails[1].width","<string>")
success = json.UpdateString("brand.signature_template","<string>")
success = json.UpdateString("brand.ticket_form_ids","<array>")
success = json.UpdateString("brand.updated_at","<dateTime>")
success = json.UpdateString("brand.url","<string>")
http.SetRequestHeader "Content-Type","application/json"
http.SetRequestHeader "Accept","application/json"
Dim sbRequestBody As New Chilkat.StringBuilder
success = json.EmitSb(sbRequestBody)
Dim resp As Chilkat.HttpResponse
resp = http.PTextSb("PUT","https://example.zendesk.com/api/v2/brands/:brand_id",sbRequestBody,"utf-8","application/json",False,False)
If (http.LastMethodSuccess = False) Then
System.DebugLog(http.LastErrorText)
Return
End If
Dim sbResponseBody As New Chilkat.StringBuilder
success = resp.GetBodySb(sbResponseBody)
Dim jResp As New Chilkat.JsonObject
success = jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False
System.DebugLog("Response Body:")
System.DebugLog(jResp.Emit())
Dim respStatusCode As Int32
respStatusCode = resp.StatusCode
System.DebugLog("Response Status Code = " + Str(respStatusCode))
If (respStatusCode >= 400) Then
System.DebugLog("Response Header:")
System.DebugLog(resp.Header)
System.DebugLog("Failed.")
Return
End If
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "brand": {
// "name": "<string>",
// "subdomain": "<string>",
// "active": "<boolean>",
// "brand_url": "<string>",
// "created_at": "<dateTime>",
// "default": "<boolean>",
// "has_help_center": "<boolean>",
// "help_center_state": "enabled",
// "host_mapping": "<string>",
// "id": "<integer>",
// "is_deleted": "<boolean>",
// "logo": {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>",
// "thumbnails": [
// {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>"
// },
// {
// "content_type": "<string>",
// "content_url": "<string>",
// "deleted": "<boolean>",
// "file_name": "<string>",
// "height": "<string>",
// "id": "<integer>",
// "inline": "<boolean>",
// "malware_access_override": "<boolean>",
// "malware_scan_result": "<string>",
// "mapped_content_url": "<string>",
// "size": "<integer>",
// "url": "<string>",
// "width": "<string>"
// }
// ]
// },
// "signature_template": "<string>",
// "ticket_form_ids": "<array>",
// "updated_at": "<dateTime>",
// "url": "<string>"
// }
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
Dim content_type As String
Dim content_url As String
Dim deleted As String
Dim file_name As String
Dim height As String
Dim id As String
Dim inline As String
Dim malware_access_override As String
Dim malware_scan_result As String
Dim mapped_content_url As String
Dim size As String
Dim url As String
Dim width As String
Dim Name As String
Name = jResp.StringOf("brand.name")
Dim Subdomain As String
Subdomain = jResp.StringOf("brand.subdomain")
Dim Active As String
Active = jResp.StringOf("brand.active")
Dim Brand_url As String
Brand_url = jResp.StringOf("brand.brand_url")
Dim Created_at As String
Created_at = jResp.StringOf("brand.created_at")
Dim Default As String
Default = jResp.StringOf("brand.default")
Dim Has_help_center As String
Has_help_center = jResp.StringOf("brand.has_help_center")
Dim Help_center_state As String
Help_center_state = jResp.StringOf("brand.help_center_state")
Dim Host_mapping As String
Host_mapping = jResp.StringOf("brand.host_mapping")
Dim Id As String
Id = jResp.StringOf("brand.id")
Dim Is_deleted As String
Is_deleted = jResp.StringOf("brand.is_deleted")
Dim Content_type As String
Content_type = jResp.StringOf("brand.logo.content_type")
Dim Content_url As String
Content_url = jResp.StringOf("brand.logo.content_url")
Dim Deleted As String
Deleted = jResp.StringOf("brand.logo.deleted")
Dim File_name As String
File_name = jResp.StringOf("brand.logo.file_name")
Dim Height As String
Height = jResp.StringOf("brand.logo.height")
Dim LogoId As String
LogoId = jResp.StringOf("brand.logo.id")
Dim Inline As String
Inline = jResp.StringOf("brand.logo.inline")
Dim Malware_access_override As String
Malware_access_override = jResp.StringOf("brand.logo.malware_access_override")
Dim Malware_scan_result As String
Malware_scan_result = jResp.StringOf("brand.logo.malware_scan_result")
Dim Mapped_content_url As String
Mapped_content_url = jResp.StringOf("brand.logo.mapped_content_url")
Dim Size As String
Size = jResp.StringOf("brand.logo.size")
Dim v_Url As String
v_Url = jResp.StringOf("brand.logo.url")
Dim Width As String
Width = jResp.StringOf("brand.logo.width")
Dim Signature_template As String
Signature_template = jResp.StringOf("brand.signature_template")
Dim Ticket_form_ids As String
Ticket_form_ids = jResp.StringOf("brand.ticket_form_ids")
Dim Updated_at As String
Updated_at = jResp.StringOf("brand.updated_at")
Dim brandUrl As String
brandUrl = jResp.StringOf("brand.url")
Dim i As Int32
i = 0
Dim count_i As Int32
count_i = jResp.SizeOfArray("brand.logo.thumbnails")
While i < count_i
jResp.I = i
content_type = jResp.StringOf("brand.logo.thumbnails[i].content_type")
content_url = jResp.StringOf("brand.logo.thumbnails[i].content_url")
deleted = jResp.StringOf("brand.logo.thumbnails[i].deleted")
file_name = jResp.StringOf("brand.logo.thumbnails[i].file_name")
height = jResp.StringOf("brand.logo.thumbnails[i].height")
id = jResp.StringOf("brand.logo.thumbnails[i].id")
inline = jResp.StringOf("brand.logo.thumbnails[i].inline")
malware_access_override = jResp.StringOf("brand.logo.thumbnails[i].malware_access_override")
malware_scan_result = jResp.StringOf("brand.logo.thumbnails[i].malware_scan_result")
mapped_content_url = jResp.StringOf("brand.logo.thumbnails[i].mapped_content_url")
size = jResp.StringOf("brand.logo.thumbnails[i].size")
url = jResp.StringOf("brand.logo.thumbnails[i].url")
width = jResp.StringOf("brand.logo.thumbnails[i].width")
i = i + 1
Wend
Curl Command
curl -u login:password -X PUT
-H "Content-Type: application/json"
-H "Accept: application/json"
-d '{
"brand": {
"name": "<string>",
"subdomain": "<string>",
"active": "<boolean>",
"brand_url": "<string>",
"created_at": "<dateTime>",
"default": "<boolean>",
"has_help_center": "<boolean>",
"help_center_state": "enabled",
"host_mapping": "<string>",
"id": "<integer>",
"is_deleted": "<boolean>",
"logo": {
"content_type": "<string>",
"content_url": "<string>",
"deleted": "<boolean>",
"file_name": "<string>",
"height": "<string>",
"id": "<integer>",
"inline": "<boolean>",
"malware_access_override": "<boolean>",
"malware_scan_result": "<string>",
"mapped_content_url": "<string>",
"size": "<integer>",
"url": "<string>",
"width": "<string>",
"thumbnails": [
{
"content_type": "<string>",
"content_url": "<string>",
"deleted": "<boolean>",
"file_name": "<string>",
"height": "<string>",
"id": "<integer>",
"inline": "<boolean>",
"malware_access_override": "<boolean>",
"malware_scan_result": "<string>",
"mapped_content_url": "<string>",
"size": "<integer>",
"url": "<string>",
"width": "<string>"
},
{
"content_type": "<string>",
"content_url": "<string>",
"deleted": "<boolean>",
"file_name": "<string>",
"height": "<string>",
"id": "<integer>",
"inline": "<boolean>",
"malware_access_override": "<boolean>",
"malware_scan_result": "<string>",
"mapped_content_url": "<string>",
"size": "<integer>",
"url": "<string>",
"width": "<string>"
}
]
},
"signature_template": "<string>",
"ticket_form_ids": "<array>",
"updated_at": "<dateTime>",
"url": "<string>"
}
}'
https://example.zendesk.com/api/v2/brands/:brand_id
Postman Collection Item JSON
{
"name": "Update a Brand",
"request": {
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"brand\": {\n \"name\": \"<string>\",\n \"subdomain\": \"<string>\",\n \"active\": \"<boolean>\",\n \"brand_url\": \"<string>\",\n \"created_at\": \"<dateTime>\",\n \"default\": \"<boolean>\",\n \"has_help_center\": \"<boolean>\",\n \"help_center_state\": \"enabled\",\n \"host_mapping\": \"<string>\",\n \"id\": \"<integer>\",\n \"is_deleted\": \"<boolean>\",\n \"logo\": {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\",\n \"thumbnails\": [\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n },\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n }\n ]\n },\n \"signature_template\": \"<string>\",\n \"ticket_form_ids\": \"<array>\",\n \"updated_at\": \"<dateTime>\",\n \"url\": \"<string>\"\n }\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v2/brands/:brand_id",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"brands",
":brand_id"
],
"variable": [
{
"key": "brand_id",
"value": "<integer>"
}
]
},
"description": "Returns an updated brand.\n\n#### Allowed for\n* Admins\n\n#### Updating a Brand's Image\nA brand image can be updated by uploading a local file using the update brand endpoint. See the **Using curl** sections below for more information."
},
"response": [
{
"name": "Successful response",
"originalRequest": {
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: basic",
"key": "Authorization",
"value": "Basic <credentials>"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"brand\": {\n \"name\": \"<string>\",\n \"subdomain\": \"<string>\",\n \"active\": \"<boolean>\",\n \"brand_url\": \"<string>\",\n \"created_at\": \"<dateTime>\",\n \"default\": \"<boolean>\",\n \"has_help_center\": \"<boolean>\",\n \"help_center_state\": \"enabled\",\n \"host_mapping\": \"<string>\",\n \"id\": \"<integer>\",\n \"is_deleted\": \"<boolean>\",\n \"logo\": {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\",\n \"thumbnails\": [\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n },\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n }\n ]\n },\n \"signature_template\": \"<string>\",\n \"ticket_form_ids\": \"<array>\",\n \"updated_at\": \"<dateTime>\",\n \"url\": \"<string>\"\n }\n}",
"options": {
"raw": {
"headerFamily": "json",
"language": "json"
}
}
},
"url": {
"raw": "{{baseUrl}}/api/v2/brands/:brand_id",
"host": [
"{{baseUrl}}"
],
"path": [
"api",
"v2",
"brands",
":brand_id"
],
"variable": [
{
"key": "brand_id"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [
],
"body": "{\n \"brand\": {\n \"name\": \"<string>\",\n \"subdomain\": \"<string>\",\n \"active\": \"<boolean>\",\n \"brand_url\": \"<string>\",\n \"created_at\": \"<dateTime>\",\n \"default\": \"<boolean>\",\n \"has_help_center\": \"<boolean>\",\n \"help_center_state\": \"enabled\",\n \"host_mapping\": \"<string>\",\n \"id\": \"<integer>\",\n \"is_deleted\": \"<boolean>\",\n \"logo\": {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\",\n \"thumbnails\": [\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n },\n {\n \"content_type\": \"<string>\",\n \"content_url\": \"<string>\",\n \"deleted\": \"<boolean>\",\n \"file_name\": \"<string>\",\n \"height\": \"<string>\",\n \"id\": \"<integer>\",\n \"inline\": \"<boolean>\",\n \"malware_access_override\": \"<boolean>\",\n \"malware_scan_result\": \"<string>\",\n \"mapped_content_url\": \"<string>\",\n \"size\": \"<integer>\",\n \"url\": \"<string>\",\n \"width\": \"<string>\"\n }\n ]\n },\n \"signature_template\": \"<string>\",\n \"ticket_form_ids\": \"<array>\",\n \"updated_at\": \"<dateTime>\",\n \"url\": \"<string>\"\n }\n}"
}
]
}
