Skip to main content
PUT
Update an Opportunity by UUID.

Authorizations

x-api-key
string
header
required

Path Parameters

opportunity_uuid
string
required

Body

application/json
close_date
string | null

ISO 8601 date, e.g. '2026-08-07'. An ISO 8601 datetime is accepted and truncated to its date. Any other format is rejected with 400 -- these columns are dates, so locale-shaped values like '08/07/2026' are ambiguous and partial values like '2026-08' are not dates at all.

custom_fields
OpportunityCustomFieldInput · object[] | null
details
string | null
intro_date
string | null

ISO 8601 date, e.g. '2026-08-07'. An ISO 8601 datetime is accepted and truncated to its date. Any other format is rejected with 400 -- these columns are dates, so locale-shaped values like '08/07/2026' are ambiguous and partial values like '2026-08' are not dates at all.

intro_person_uuid
string | null
name
string | null
next_step
string | null
owner_user_uuid
string | null

User UUID of the opportunity owner, as returned by GET /v1/users. The person UUID reported under owner on opportunity reads is accepted too, since that is what the record actually stores. A value matching neither is rejected with 400.

parent_uuid
string | null
probability
integer | null
source_date
string | null

ISO 8601 date, e.g. '2026-08-07'. An ISO 8601 datetime is accepted and truncated to its date. Any other format is rejected with 400 -- these columns are dates, so locale-shaped values like '08/07/2026' are ambiguous and partial values like '2026-08' are not dates at all.

stage_uuid
string | null
type_uuid
string | null
value
integer | null

Response

200 - application/json

Minimal response body for opportunity create/update.

uuid
string
required
created_at
number | null
updated_at
number | null