Skip to main content
PATCH
/
brands
/
{brand_id}
Update Brand
curl --request PATCH \
  --url https://api.scrunchai.com/v1/brands/{brand_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "alternative_names": [
    "<string>"
  ],
  "website": "<string>",
  "alternative_websites": [
    "<string>"
  ],
  "description": "<string>",
  "competitors": [
    {
      "name": "<string>",
      "id": 123,
      "alternative_names": [],
      "websites": []
    }
  ],
  "personas": [
    {
      "name": "<string>",
      "description": "<string>",
      "id": 123
    }
  ],
  "key_topics": [
    "<string>"
  ],
  "status": "lead"
}
'
{
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "website": "<string>",
  "status": "<string>",
  "alternative_websites": [],
  "competitors": [],
  "personas": [],
  "key_topics": []
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
integer
required

Body

application/json

Partial update payload for a brand.

Only fields present in the request body are updated. Omitted fields are left unchanged. For competitors and personas, the provided list replaces the current state: existing records not included in the list are archived.

name
string | null

Brand display name.

alternative_names
string[] | null

Alternative names or aliases for the brand.

website
string | null

Primary website URL.

alternative_websites
string[] | null

Additional website URLs for the brand.

description
string | null

Short description of the brand.

competitors
APICompetitorPatchInput · object[] | null

Full desired list of competitors. Existing competitors not in this list are archived.

personas
APIPersonaPatchInput · object[] | null

Full desired list of personas. Existing personas not in this list are archived.

key_topics
string[] | null

Key topics associated with the brand.

status
enum<string> | null

Brand status. Allowed values: lead, customer.

Available options:
lead,
customer

Response

Successful Response

id
integer
required
name
string
required
description
string
required
website
string
required
status
string
required
alternative_websites
string[]
competitors
APICompetitorListing · object[]
personas
APIPersonaListing · object[]
key_topics
string[]