Meetings

Suggest Deal Next Best Step

One recommended next action for this deal. SPENDS CREDITS. Writes nothing.

POST because every call is a fresh model call. Gated on READ access to the deal, as in the app: recommending is not editing. 502 when the model call fails.

post/deals/{deal_id}/next-best-step

Request

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

Path parameters

deal_idstring required

Deal id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataCrmRecordPayload required

An open envelope for one record, one dashboard or one job receipt.

Open because most of these reads are COMPUTED shapes - an engagement summary, a next-best-step, an intelligence status - that grow with the product, and dropping a field from an advisory read makes it say "nothing to report" rather than "we did not tell you".

Changes

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