---
title: "POST /#X-Amz-Target=CostOptimizationHubService.UpdatePreferences"
method: POST
path: "/#X-Amz-Target=CostOptimizationHubService.UpdatePreferences"
---

# POST /#X-Amz-Target=CostOptimizationHubService.UpdatePreferences

`POST /#X-Amz-Target=CostOptimizationHubService.UpdatePreferences`

Updates a set of preferences for an account in order to add account-specific preferences into the service. These preferences impact how the savings associated with recommendations are presented.

## Headers

- `X-Amz-Target` 'CostOptimizationHubService.UpdatePreferences', required

## Request body

- UpdatePreferencesRequest
  - `savingsEstimationMode` 'BeforeDiscounts' | 'AfterDiscounts' — Sets the "savings estimation mode" preference.
  - `memberAccountDiscountVisibility` 'All' | 'None' — Sets the "member account discount visibility" preference.
  - `preferredCommitment` object — Sets the preferences for how Reserved Instances and Savings Plans cost-saving opportunities are prioritized in terms of payment option and term length.
    - `term` 'OneYear' | 'ThreeYears' — The preferred length of the commitment period. If the value is null, it will default to <code>ThreeYears</code> (highest savings) where applicable.
    - `paymentOption` 'AllUpfront' | 'PartialUpfront' | 'NoUpfront' — The preferred upfront payment structure for commitments. If the value is null, it will default to <code>AllUpfront</code> (highest savings) where applicable.

## Response `200`

Success

- UpdatePreferencesResponse
  - `savingsEstimationMode` 'BeforeDiscounts' | 'AfterDiscounts' — Shows the status of the "savings estimation mode" preference.
  - `memberAccountDiscountVisibility` 'All' | 'None' — Shows the status of the "member account discount visibility" preference.
  - `preferredCommitment` object — Shows the updated preferences for how Reserved Instances and Savings Plans cost-saving opportunities are prioritized in terms of payment option and term length.
    - `term` 'OneYear' | 'ThreeYears' — The preferred length of the commitment period. If the value is null, it will default to <code>ThreeYears</code> (highest savings) where applicable.
    - `paymentOption` 'AllUpfront' | 'PartialUpfront' | 'NoUpfront' — The preferred upfront payment structure for commitments. If the value is null, it will default to <code>AllUpfront</code> (highest savings) where applicable.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — AccessDeniedException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/cost-optimization-hub.md) · [All operations](https://skmtc.net/aws/apis/cost-optimization-hub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cost-optimization-hub/versions/fb30b7c46a54/schema)