---
title: "POST /update-billing-group"
method: POST
path: "/update-billing-group"
---

# POST /update-billing-group

`POST /update-billing-group`

This updates an existing billing group.

## Request body

- object
  - `Arn` string, required — The Amazon Resource Name (ARN) of the billing group being updated.
  - `Name` string, password — The name of the billing group. The names must be unique to each billing group.
  - `Status` 'ACTIVE' | 'PRIMARY_ACCOUNT_MISSING' | 'PENDING' — The status of the billing group. Only one of the valid values can be used.
  - `ComputationPreference` object — The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.
    - `PricingPlanArn` string — The Amazon Resource Name (ARN) of the pricing plan that's used to compute the Amazon Web Services charges for a billing group.
  - `Description` string, password — A description of the billing group.
  - `AccountGrouping` object — Specifies if the billing group has the following features enabled.
    - `AutoAssociate` boolean — Specifies if this billing group will automatically associate newly added Amazon Web Services accounts that join your consolidated billing family.
    - `ResponsibilityTransferArn` string — The Amazon Resource Name (ARN) that identifies the transfer relationship. Note: Modifications to the ResponsibilityTransferArn are not permitted for existing billing groups.

## Response `200`

Success

- UpdateBillingGroupOutput
  - `Arn` string — The Amazon Resource Name (ARN) of the billing group that was updated.
  - `Name` string, password — The name of the billing group. The names must be unique to each billing group.
  - `Description` string, password — A description of the billing group.
  - `PrimaryAccountId` string — The account ID that serves as the main account in a billing group.
  - `PricingPlanArn` string — The Amazon Resource Name (ARN) of the pricing plan to compute Amazon Web Services charges for the billing group.
  - `Size` integer — The number of accounts in the particular billing group.
  - `LastModifiedTime` integer — The most recent time when the billing group was modified.
  - `Status` 'ACTIVE' | 'PRIMARY_ACCOUNT_MISSING' | 'PENDING' — The status of the billing group. Only one of the valid values can be used.
  - `StatusReason` string — The reason why the billing group is in its current status.
  - `AccountGrouping` object — Specifies if the billing group has automatic account association (<code>AutoAssociate</code>) enabled.
    - `AutoAssociate` boolean — Specifies if this billing group will automatically associate newly added Amazon Web Services accounts that join your consolidated billing family.
    - `ResponsibilityTransferArn` string — The Amazon Resource Name (ARN) that identifies the transfer relationship. Note: Modifications to the ResponsibilityTransferArn are not permitted for existing billing groups.

## Other responses

- `480` — ConflictException
- `481` — ThrottlingException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — InternalServerException
- `485` — ResourceNotFoundException

---

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