Detect Deal Competitors
Deals
Detect Competitors
POST
Detect Deal Competitors
Gated by the
ai.deal_competitors config feature flag — a 403 names the flag when disabled. This is a separate flag from the ai.competitive_intelligence flag that gates the full brief endpoints below.
The cheap sibling of the full brief — just names, no analysis. Requires the deal to have a linked account with a non-empty name. Runs a 4-step cascade (Perplexity → Exa fallback if fewer than 3 hits → LLM merge/dedup → pure LLM inference if nothing was found) and replaces the deal’s deal_competitors rows with the result.
Auth
Requires a CRM manage scope and an active organization on the token. Any*:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.
Response
Errors
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The deal's id.
Body
application/json
Re-run detection even if competitors are already recorded on the deal.
Response
Successful Response