Skip to main content
PATCH
/
v1
/
deals
/
:id
Update Deal
curl --request PATCH \
  --url https://api.example.com/v1/deals/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "stage": "<string>",
  "status": "<string>",
  "pipeline": "<string>",
  "estimated_value": 123,
  "priority": "<string>",
  "notes": "<string>",
  "tags": [
    {}
  ],
  "contact_id": "<string>",
  "owner_id": "<string>",
  "deal_type": "<string>",
  "closed_date": "<string>",
  "description": "<string>",
  "follow_up_date": "<string>",
  "probability": 123,
  "currency": "<string>"
}
'
{
  "data": {}
}

Request

Path Parameters

id
string
required
Deal ID (UUID)

Body Parameters

All fields are optional. Only provided fields will be updated.
name
string
Deal name
stage
string
Deal stage
status
string
Deal status (active, won, lost)
pipeline
string
Pipeline name
estimated_value
number
Estimated value
priority
string
Priority level
notes
string
Deal notes
tags
array
Tags (replaces existing)
contact_id
string
Primary contact ID
owner_id
string
Owner user ID
deal_type
string
Deal/matter type
closed_date
string
Close date (ISO 8601)
description
string
High-level description
follow_up_date
string
Next follow-up date
probability
number
Win probability (0-100)
currency
string
Currency code

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json

Response

data
object
The updated deal object with all fields
curl -X PATCH https://data.leadlex.com/functions/v1/api-gateway/v1/deals/deal-001 \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "stage": "Negotiation", "estimated_value": 75000 }'

Errors

StatusCodeDescription
404not_foundDeal not found
403insufficient_permissionsMissing deals:write permission