Deals

Bulk Update Deals

Apply ONE change to up to 100 deals.

PUT semantics on every field of change: null leaves a value alone, an EMPTY STRING clears it. Omitting a field and sending "" are therefore different instructions and the second one is destructive.

Read the per-deal result rather than the HTTP status: a deal the caller cannot write is reported, not fatal.

post/deals/bulk

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/deals/bulk
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

deal_idsstring[] required

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.