SEsearchable
Brand

Update brand profile

Changed on

Update a subset of the project's knowledge-base brand fields (name, headline, description, positioning, category, influence, language, websiteUrl, caseSensitive, brandNameDisambiguation, topics) and its Tone / Writing Style and Memory documents (tone, memory, each replaced whole). Does not touch connectedEntities, eeatData, or the project's default location. Requires the knowledge:manage capability. A pitch project that is not currently active refuses with 409 INACTIVE_PITCH_PROMPT_MUTATION.

patch/api/mcp/projects/{projectId}/brand-profile

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Request body

namestring
headlinestring
descriptionstring

A longer factual description. The app doesn't show it; topic assignment and some other analyses read it.

positioningstring

What the brand does: the app's Brand Context box, read by prompt generation and most analyses.

categorystring
influence'global' | 'national-global' | 'nationwide' | 'regional' | 'local'

Where the brand sells (the app's Geographic reach). Does not change the default location.

languagestring

A language code the app offers, e.g. en-GB.

websiteUrlstring
caseSensitiveboolean

The app's Exact match only: count only mentions with the brand name's exact spelling and capitalization.

brandNameDisambiguationstring
topicsstring[]
tonestring

The Knowledge Base's Tone / Writing Style document: free-form markdown on the brand's voice, adjectives, phrases to avoid and language to include, which the app's agents follow when they write. Replaces the whole document; an empty string clears it.

memorystring

The Knowledge Base's Memory document: free-form markdown facts and preferences the app's agents keep in mind. Replaces the whole document; an empty string clears it.

Response

Brand profile updated.

successboolean required
action'created' | 'updated' | 'unchanged' required

Whether the knowledge-base row was created, updated, or left unchanged (no field in the request differed from the stored value). The tone and memory documents are not part of that row; see updatedDocuments.

updatedDocumentsstring[] required

The writing documents this request replaced; empty when it sent neither.

Changes