action

Updates name, website (normalized domain), industry, city, state, disambiguation, description, services, value proposition, audience, differentiators, money_pages, or primary flag for an owned business. Changing website triggers a fresh site crawl. Free. Requires business:write. money_pages are existing URLs recs must target.

post/update_business

Request

  • Base URL: https://scope.online/v1
  • URL: https://scope.online/v1/update_business
  • Auth: HTTP bearer

Request body

business_idstring uuid required

Owned Scope business ID

websitestring

Public website URL (https). Normalized to canonical domain; triggers site re-crawl when changed.

namestring

Business name

industrystring

Industry

citystring

City

statestring

State or region

disambiguationstring

One-sentence entity disambiguation

descriptionstring

What the product is, in one or two sentences

value_propositionstring

Primary customer promise

target_audiencestring

Who this is for

servicesstring[]

Services or product lines

key_differentiatorsstring[]

Short differentiators

money_pagesstring[]

Existing URLs or paths recs must target. Do not invent new guides.

never_new_urlboolean

If true, generate_fix may only edit registered money_pages

forbid_lede_patternsstring[]

Blocked phrases in generated copy (empty array clears stored patterns)

price_urlstring

Existing pricing URL

homonym_packobject

Structured us/not entities for scoring. Not copy to paste under H1.

index_status'unknown' | 'indexed' | 'not_indexed'

unknown | indexed | not_indexed

webhook_urlstring

HTTPS URL for why-first scan-complete payloads

is_primaryboolean

Set this business as primary

Response

Tool payload. meta holds tldr, next[], pagination cursors, and request_id.

Changes

No recorded changes to this operation across all 1 revision of this API.