Start free trial

Mark a deal lost

POST/api/v1/o2c/deals/{deal_id}/mark-lost

Close an open deal as lost with a required reason.

Operation ID: mark_deal_lost_api_v1_o2c_deals__deal_id__mark_lost_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

deal_idstringrequired

Request body

Schema: DealMarkLostRequest

reasonstringrequired

One of ['competitor', 'no_budget', 'no_decision', 'other', 'poor_fit', 'price', 'timing'].

notestring

Optional context on why it was lost.

Responses

201Successful Response

Schema: SuccessEnvelope_DealResponse_

successboolean
messagestring
codestring
dataDealResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject