Deals

Set Rival Attach

Record which competitor is on this deal, and how it is going.

A null competitor_id DETACHES the current one - the same route both attaches and clears.

post/deals/{deal_id}/rival-attach

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/deals/{deal_id}/rival-attach
  • Auth: HTTP bearer

Path parameters

deal_idstring required

Deal id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

competitor_idstring nullable

The competitor. Null detaches the current one.

statusstring required

Where the deal stands against them.

Response

Successful Response

dataDealPayload required

An open envelope for a deal, a merge preview or a column result.

Open because the crossfire and merge-preview payloads are computed shapes that grow with the product, and a closed model would drop a field from an ADVISORY read - where a missing signal reads as "nothing to worry about" rather than "we did not tell you".

Changes

No recorded changes to this operation across all 2 revisions of this API.