Update a deal
Early access: request API access for your workspace at https://bauhow.com/support before using this endpoint.
Moves stages, sets the status (won/lost), archives and links a project.
PATCH
/v1/deals/{id}Authorization
AuthorizationBearer token · headerrequiredWorkspace API key (bh_…).
Path parameters
idstringrequiredmin length 1
Request body
application/jsoncontactIdstringmin length 1
titlestringmin length 1 · max length 200
valuenumber | nullShow propertiesHide properties
Any of:
number
numbernull
nullstageIdstringmin length 1
statusstringAllowed:
openwonlostownerIdstring | nullShow propertiesHide properties
Any of:
string
stringnull
nullprojectTypeIdsstring[]max items 50
streetstring | nullShow propertiesHide properties
Any of:
string
stringnull
nullpostalCodestring | nullShow propertiesHide properties
Any of:
string
stringnull
nullcitystring | nullShow propertiesHide properties
Any of:
string
stringnull
nullnotesstring | nullShow propertiesHide properties
Any of:
string
stringnull
nullprojectIdstring | nullShow propertiesHide properties
Any of:
string
stringnull
nullarchivedbooleanResponses
200
OK
idstringrequiredcontactIdstringrequiredtitlestringrequiredvaluenumber | nullrequiredShow propertiesHide properties
Any of:
number
numbernull
nullstageIdstringrequiredstageEnteredAtstring<date-time>requiredstatusstringrequiredAllowed:
openwonlostownerIdstring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullprojectTypeIdsstring[]requiredstreetstring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullpostalCodestring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullcitystring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullnotesstring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullprojectIdstring | nullrequiredShow propertiesHide properties
Any of:
string
stringnull
nullclosedAtstring<date-time> | nullrequiredShow propertiesHide properties
Any of:
string<date-time>
string<date-time>null
nullarchivedAtstring<date-time> | nullrequiredShow propertiesHide properties
Any of:
string<date-time>
string<date-time>null
nullcreatedAtstring<date-time>requiredupdatedAtstring<date-time>required