Skip to main content
POST
Move a competitor to the brand

Authorizations

Authorization
string
header
required

A Searchable API key, created under Manage Account → Integrations → API Keys. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.

Headers

Idempotency-Key
string

Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.

Path Parameters

projectId
string<uuid>
required

The project id.

competitorId
string<uuid>
required

The competitor's id.

Response

Move to the brand queued.

success
boolean
required
status
enum<string>
required

The change is queued; it runs in the background.

Available options:
queued
competitor
object
required
alternativeNames
string[]
required

The names that become the brand's alternative names: its own and its name variations.