---
title: "POST /#X-Amz-Target=AWSBilling.UpdateBillingPreferences"
method: POST
path: "/#X-Amz-Target=AWSBilling.UpdateBillingPreferences"
---

# POST /#X-Amz-Target=AWSBilling.UpdateBillingPreferences

`POST /#X-Amz-Target=AWSBilling.UpdateBillingPreferences`

Updates billing preferences for the specified feature. Each feature targets a distinct billing capability and has its own set of supported keys. The action sets the value for each provided key; keys not present in the request are unchanged.

Sharing keys (`RI_SHARING`, `CREDIT_SHARING`, `CREDIT_LEVEL_SHARING`, and sharing keys under `CREDIT_PREFERENCE_OPTIONS`) may only be set by the management account of a consolidated billing family. The `credit/{creditId}/status` key may be set by member accounts for credits they own, or by the management account for any credit in the family.

## Headers

- `X-Amz-Target` 'AWSBilling.UpdateBillingPreferences', required

## Request body

- UpdateBillingPreferencesRequest
  - `feature` 'RI_SHARING' | 'RI_SHARING_HISTORY' | 'CREDIT_SHARING' | 'CREDIT_SHARING_HISTORY' | 'CREDIT_LEVEL_SHARING' | 'BILLING_ALERTS' | 'CREDIT_PREFERENCE_OPTIONS', required — The feature to update. Valid values: <code>BILLING_ALERTS</code>, <code>RI_SHARING</code>, <code>CREDIT_SHARING</code>, <code>CREDIT_LEVEL_SHARING</code>, <code>CREDIT_PREFERENCE_OPTIONS</code>. The history features (<code>RI_SHARING_HISTORY</code> and <code>CREDIT_SHARING_HISTORY</code>) are read-only and cannot be updated.
  - `billingPreferencesPerKey` BillingPreferenceForKey[], required — Key/value pairs to apply. All keys in a single request must be valid for the specified <code>feature</code> and must not be duplicated. For <code>CREDIT_PREFERENCE_OPTIONS</code>, all keys must reference the same <code>creditId</code>.
    - `key` string, required — The preference key. Format depends on the feature being updated.
    - `value` 'ENABLED' | 'DISABLED', required — The preference value. Valid values: <code>ENABLED</code> or <code>DISABLED</code>.

## Response `200`

Success

- UpdateBillingPreferencesResponse

## Other responses

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

---

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