Clean up brands and competitors
Inspect missing brands, duplicates, domains, and aliases, then verify approved changes.
When to use this workflow
“The same brand appears under different names; clean up the competitor setup too.”
Before fetching
Confirm canonical names, official domains, and owned-versus-competitor relations. Distinguish spelling variants from different companies; names alone do not establish identity.
Complete the CLI quickstart and confirm the workspace with orc workspace current --json. Replace example IDs, URLs, dates, and settings. Apply only approved mutations.
1. Compare configured brands and suggestions
If this workspace has no brands yet, create your owned brand first. Replace the name and domain with the actual target, then use the returned ID as YOUR_BRAND_ID. Registering a brand alone does not start prompt measurement.
orc brands create --workspace WORKSPACE_ID --name 'YOUR_BRAND_NAME' --domain 'YOUR_OFFICIAL_DOMAIN' --relation owned --json
orc brands get YOUR_BRAND_ID --workspace WORKSPACE_ID --jsonThe default list contains owned brands and direct competitors. Specify relation to inspect indirect or ignored brands as needed. Cross-check unconfigured brands found in answers with suggestions.
orc brands list --json
orc brands list --relation indirect_competitor --json
orc brands suggestions list --json
orc brands get YOUR_BRAND_ID --json2. Apply the approved correction
Pass the complete alias set, retaining existing aliases. Apply the approved domain and display color, then read the same ID back. This update does not merge duplicate histories.
orc brands update YOUR_BRAND_ID --domain 'example.com' --aliases 'YOUR_EXISTING_ALIAS,YOUR_APPROVED_ALIAS' --color-hex '#2563eb' --json
orc brands get YOUR_BRAND_ID --jsonDeliverable
Deliver before-and-after fields and brand IDs, unresolved duplicate candidates, and names to check in subsequent observations.
On fetch failure, retain the error and request scope. Do not count empty data, incomplete pagination, or missing permissions as a completed investigation.
Next steps
If a failure remains, report it and verify the fix, including this workflow and the failed step.