Update an opportunity
*status_id*
- See description for `status_id` in `POST /opportunity/` above.
- Setting the `status_id` to a status with a type of `won` will automatically set the `date_won` field if it is not already set or provided in the request. Reverting it from a `won` status to an `active` or `lost` will not automatically change `date_won`.
*date_won* (optional):
- If not set on the resource or in the request, the `date_won` will be set automatically to today's date when setting `status_id` to a status with type `won`. The `x-tz-offset` header, used to pass your timezone's UTC offset, will be taken into account.
*custom.FIELD_ID* (optional)
- See description for `custom.FIELD_ID` in `POST /opportunity/` above.
- Additionally, you can unset a single field by using `{ "custom.FIELD_ID": null }`, e.g.:
```
{ "custom.cf_v6S011I6MqcbVvB2FA5Nk8dr5MkL8sWuCiG8cUleO9c": null }
```
If you're trying to update a custom field and that custom field accepts multiple values, you can also specify `.add` or `.remove` as part of the field key to add/remove a single value to/from a list of values, e.g.:
```
{ "custom.cf_v6S011I6MqcbVvB2FA5Nk8dr5MkL8sWuCiG8cUleO9c.add": "Wednesday" }
```
Authentication
AuthorizationBasic
Basic authentication of the form Basic <base64(username:)>.
OR
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
id
Request
This endpoint expects any.
Response
Successful response
annualized_expected_value
annualized_value
confidence
contact_id
created_by
date_created
date_lost
date_updated
date_won
expected_value
id
lead_id
note
organization_id
status_id
updated_by
user_id
value
value_period
Allowed values:
attachments
comment_summary
contact_name
created_by_name
integration_links
is_stalled
lead_name
lead_primary_email
lead_primary_phone
pipeline_id
pipeline_name
stall_status
status_display_name
status_label
status_type
Allowed values:
suggested_action
updated_by_name
user_name
value_currency
value_formatted
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error