Rename the brand

Renames the brand, as the name field in the dashboard does. It also renames every campaign that carried the old name, with its join code and chat code; the old chat code keeps working for a few days. The name is 1 to 120 characters.

PATCHhttps://api.tryscouty.com/v1/brand/name

Scopebrand:write
Write
Safe to retry
MCP toolscouty_rename_brand

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the brand:write scope, or the call answers 403 insufficient_scope. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Headers

Name	Type	Required	Description
`Idempotency-Key`	`string`	Optional	The same key the body's idempotencyKey carries. Send one or the other, or both with the same value.

Body parameters

A JSON object, sent with Content-Type: application/json.

Name	Type	Required	Description
`idempotencyKey`	`string`	Required	A key you choose for this call, 8 to 128 characters of letters, digits, dot, underscore, colon or hyphen. Sending the same key with the same arguments replays the first answer and changes nothing, so a retry after a timeout is safe.
`name`	`string`	Required	The brand's new name, 1 to 120 characters.

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
400 Bad Request	`invalid_request`	The request was not the shape this capability takes, or its body was not JSON.
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`insufficient_scope` `wrong_principal`	The token does not carry the scope this capability needs.
409 Conflict	`idempotency_conflict`	That idempotency key was already used for a different request. Nothing was changed.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

curl -s -X PATCH https://api.tryscouty.com/v1/brand/name \ -H "Authorization: Bearer $SCOUTY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"idempotencyKey":"rename-2026-09-28","name":"Acme Co"}'

const response = await fetch("https://api.tryscouty.com/v1/brand/name", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.SCOUTY_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ idempotencyKey: "rename-2026-09-28", name: "Acme Co" }), }); console.log(await response.json());

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.patch( "https://api.tryscouty.com/v1/brand/name", headers={"Authorization": f"Bearer {token}"}, json={ "idempotencyKey": "rename-2026-09-28", "name": "Acme Co", }, ) print(response.json())