Skip to main content
PATCH
Update a deal

Authorizations

Authorization
string
header
required

API key authentication. Use "Bearer <api_key>" or "Api-Key <api_key>".

Path Parameters

uuid
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json
label
string
deal_value
number

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

stage_uuid
string | null
expiration_date
string | null

Response

200 - application/json

Default Response

uuid
string
required
label
string
required
deal_value
number
required

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

total_commission_value
number | null
required

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

expiration_date
string | null
required
stage
object | null
required
lead
object
required
partner
object | null
required
partners
object[]
required

Every partner on the deal. The primary partner (is_primary: true, the same partner as the deal's partner) comes first, then each supporting (co-sell) partner, oldest first, with its role. Supporting partners appear only while the Co-selling module is enabled, and only while they are active partners of the deal's partner type.

currency
object
required
tags
object[]
required
assigned_users
object[]
required
custom_fields
object[]
required
created_at
string
required
updated_at
string
required