Perl / Support API / Update a Brand
Back to Collection Items
use chilkat();
# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.
$http = chilkat::CkHttp->new();
$http->put_BasicAuth(1);
$http->put_Login("login");
$http->put_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>"
# }
# }
$json = chilkat::CkJsonObject->new();
$json->UpdateString("brand.name","<string>");
$json->UpdateString("brand.subdomain","<string>");
$json->UpdateString("brand.active","<boolean>");
$json->UpdateString("brand.brand_url","<string>");
$json->UpdateString("brand.created_at","<dateTime>");
$json->UpdateString("brand.default","<boolean>");
$json->UpdateString("brand.has_help_center","<boolean>");
$json->UpdateString("brand.help_center_state","enabled");
$json->UpdateString("brand.host_mapping","<string>");
$json->UpdateString("brand.id","<integer>");
$json->UpdateString("brand.is_deleted","<boolean>");
$json->UpdateString("brand.logo.content_type","<string>");
$json->UpdateString("brand.logo.content_url","<string>");
$json->UpdateString("brand.logo.deleted","<boolean>");
$json->UpdateString("brand.logo.file_name","<string>");
$json->UpdateString("brand.logo.height","<string>");
$json->UpdateString("brand.logo.id","<integer>");
$json->UpdateString("brand.logo.inline","<boolean>");
$json->UpdateString("brand.logo.malware_access_override","<boolean>");
$json->UpdateString("brand.logo.malware_scan_result","<string>");
$json->UpdateString("brand.logo.mapped_content_url","<string>");
$json->UpdateString("brand.logo.size","<integer>");
$json->UpdateString("brand.logo.url","<string>");
$json->UpdateString("brand.logo.width","<string>");
$json->UpdateString("brand.logo.thumbnails[0].content_type","<string>");
$json->UpdateString("brand.logo.thumbnails[0].content_url","<string>");
$json->UpdateString("brand.logo.thumbnails[0].deleted","<boolean>");
$json->UpdateString("brand.logo.thumbnails[0].file_name","<string>");
$json->UpdateString("brand.logo.thumbnails[0].height","<string>");
$json->UpdateString("brand.logo.thumbnails[0].id","<integer>");
$json->UpdateString("brand.logo.thumbnails[0].inline","<boolean>");
$json->UpdateString("brand.logo.thumbnails[0].malware_access_override","<boolean>");
$json->UpdateString("brand.logo.thumbnails[0].malware_scan_result","<string>");
$json->UpdateString("brand.logo.thumbnails[0].mapped_content_url","<string>");
$json->UpdateString("brand.logo.thumbnails[0].size","<integer>");
$json->UpdateString("brand.logo.thumbnails[0].url","<string>");
$json->UpdateString("brand.logo.thumbnails[0].width","<string>");
$json->UpdateString("brand.logo.thumbnails[1].content_type","<string>");
$json->UpdateString("brand.logo.thumbnails[1].content_url","<string>");
$json->UpdateString("brand.logo.thumbnails[1].deleted","<boolean>");
$json->UpdateString("brand.logo.thumbnails[1].file_name","<string>");
$json->UpdateString("brand.logo.thumbnails[1].height","<string>");
$json->UpdateString("brand.logo.thumbnails[1].id","<integer>");
$json->UpdateString("brand.logo.thumbnails[1].inline","<boolean>");
$json->UpdateString("brand.logo.thumbnails[1].malware_access_override","<boolean>");
$json->UpdateString("brand.logo.thumbnails[1].malware_scan_result","<string>");
$json->UpdateString("brand.logo.thumbnails[1].mapped_content_url","<string>");
$json->UpdateString("brand.logo.thumbnails[1].size","<integer>");
$json->UpdateString("brand.logo.thumbnails[1].url","<string>");
$json->UpdateString("brand.logo.thumbnails[1].width","<string>");
$json->UpdateString("brand.signature_template","<string>");
$json->UpdateString("brand.ticket_form_ids","<array>");
$json->UpdateString("brand.updated_at","<dateTime>");
$json->UpdateString("brand.url","<string>");
$http->SetRequestHeader("Content-Type","application/json");
$http->SetRequestHeader("Accept","application/json");
$sbRequestBody = chilkat::CkStringBuilder->new();
$json->EmitSb($sbRequestBody);
# resp is a HttpResponse
$resp = $http->PTextSb("PUT","https://example.zendesk.com/api/v2/brands/:brand_id",$sbRequestBody,"utf-8","application/json",0,0);
if ($http->get_LastMethodSuccess() == 0) {
print $http->lastErrorText() . "\r\n";
exit;
}
$sbResponseBody = chilkat::CkStringBuilder->new();
$resp->GetBodySb($sbResponseBody);
$jResp = chilkat::CkJsonObject->new();
$jResp->LoadSb($sbResponseBody);
$jResp->put_EmitCompact(0);
print "Response Body:" . "\r\n";
print $jResp->emit() . "\r\n";
$respStatusCode = $resp->get_StatusCode();
print "Response Status Code = " . $respStatusCode . "\r\n";
if ($respStatusCode >= 400) {
print "Response Header:" . "\r\n";
print $resp->header() . "\r\n";
print "Failed." . "\r\n";
exit;
}
# 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
$Name = $jResp->stringOf("brand.name");
$Subdomain = $jResp->stringOf("brand.subdomain");
$Active = $jResp->stringOf("brand.active");
$Brand_url = $jResp->stringOf("brand.brand_url");
$Created_at = $jResp->stringOf("brand.created_at");
$Default = $jResp->stringOf("brand.default");
$Has_help_center = $jResp->stringOf("brand.has_help_center");
$Help_center_state = $jResp->stringOf("brand.help_center_state");
$Host_mapping = $jResp->stringOf("brand.host_mapping");
$Id = $jResp->stringOf("brand.id");
$Is_deleted = $jResp->stringOf("brand.is_deleted");
$Content_type = $jResp->stringOf("brand.logo.content_type");
$Content_url = $jResp->stringOf("brand.logo.content_url");
$Deleted = $jResp->stringOf("brand.logo.deleted");
$File_name = $jResp->stringOf("brand.logo.file_name");
$Height = $jResp->stringOf("brand.logo.height");
$LogoId = $jResp->stringOf("brand.logo.id");
$Inline = $jResp->stringOf("brand.logo.inline");
$Malware_access_override = $jResp->stringOf("brand.logo.malware_access_override");
$Malware_scan_result = $jResp->stringOf("brand.logo.malware_scan_result");
$Mapped_content_url = $jResp->stringOf("brand.logo.mapped_content_url");
$Size = $jResp->stringOf("brand.logo.size");
$v_Url = $jResp->stringOf("brand.logo.url");
$Width = $jResp->stringOf("brand.logo.width");
$Signature_template = $jResp->stringOf("brand.signature_template");
$Ticket_form_ids = $jResp->stringOf("brand.ticket_form_ids");
$Updated_at = $jResp->stringOf("brand.updated_at");
$brandUrl = $jResp->stringOf("brand.url");
$i = 0;
$count_i = $jResp->SizeOfArray("brand.logo.thumbnails");
while ($i < $count_i) {
$jResp->put_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;
}
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}"
}
]
}
