Skip to main content
PATCH
Update a deal

Authorizations

Authorization
string
header
required

API key from Settings > Developer. Format: alva_sk_...

Path Parameters

id
string<uuid>
required

The deal ID

Body

application/json

All fields are optional — send only the properties you want to update. In the interactive playground (the "Test Request" panel) the JSON body is fully editable; type over any value and delete the properties you don't need. Blank fields are ignored.

All fields are optional. Only included fields will be updated.

name
string
companyId
string<uuid>
primaryContactId
string<uuid> | null
ownerId
string<uuid>
stage
enum<string>
Available options:
discovery,
qualification,
proposal,
negotiation,
closed_won,
closed_lost
methodology
enum<string>
Available options:
meddpicc,
bant,
spiced
value
string | null
probability
string | null
expectedCloseDate
string<date-time> | null
notes
string | null
customFields
object

Response

Deal

success
boolean
Example:

true

message
string

Human-readable confirmation of the action.

data
object
resource
string