---
title: "POST /update-custom-line-item"
method: POST
path: "/update-custom-line-item"
---

# POST /update-custom-line-item

`POST /update-custom-line-item`

Update an existing custom line item in the current or previous billing period.

## Request body

- object
  - `Arn` string, required — The ARN of the custom line item to be updated.
  - `Name` string, password — The new name for the custom line item.
  - `Description` string, password — The new line item description of the custom line item.
  - `ChargeDetails` object — A representation of the new charge details of a custom line item. This should contain only one of <code>Flat</code> or <code>Percentage</code>.
    - `Flat` object — An <code>UpdateCustomLineItemFlatChargeDetails</code> that describes the new charge details of a flat custom line item.
      - `ChargeValue` number, double, required — The custom line item's new fixed charge value in USD.
    - `Percentage` object — An <code>UpdateCustomLineItemPercentageChargeDetails</code> that describes the new charge details of a percentage custom line item.
      - `PercentageValue` number, double, required — The custom line item's new percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
    - `LineItemFilters` LineItemFilter[] — A representation of the line item filter.
      - `Attribute` 'LINE_ITEM_TYPE' | 'SERVICE', required — The attribute of the line item filter. This specifies what attribute that you can filter on.
      - `MatchOption` 'NOT_EQUAL' | 'EQUAL', required — The match criteria of the line item filter. This parameter specifies whether not to include the resource value from the billing group total cost.
      - `Values` LineItemFilterValue[] — The values of the line item filter. This specifies the values to filter on. Currently, you can only exclude Savings Plans discounts.
      - `AttributeValues` AttributeValue[] — The values of the line item filter. This specifies the values to filter on.
  - `BillingPeriodRange` object — The billing period range in which the custom line item request will be applied.
    - `InclusiveStartBillingPeriod` string — The inclusive start billing period that defines a billing period range where a custom line is applied.
    - `ExclusiveEndBillingPeriod` string — The inclusive end billing period that defines a billing period range where a custom line is applied.

## Response `200`

Success

- UpdateCustomLineItemOutput
  - `Arn` string — The ARN of the successfully updated custom line item.
  - `BillingGroupArn` string — The ARN of the billing group that the custom line item is applied to.
  - `Name` string, password — The name of the successfully updated custom line item.
  - `Description` string, password — The description of the successfully updated custom line item.
  - `ChargeDetails` object — A <code>ListCustomLineItemChargeDetails</code> containing the charge details of the successfully updated custom line item.
    - `Flat` object — A <code>ListCustomLineItemFlatChargeDetails</code> that describes the charge details of a flat custom line item.
      - `ChargeValue` number, double, required — The custom line item's fixed charge value in USD.
    - `Percentage` object — A <code>ListCustomLineItemPercentageChargeDetails</code> that describes the charge details of a percentage custom line item.
      - `PercentageValue` number, double, required — The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
    - `Type` 'CREDIT' | 'FEE', required — The type of the custom line item that indicates whether the charge is a <code>fee</code> or <code>credit</code>.
    - `LineItemFilters` LineItemFilter[] — A representation of the line item filter.
      - `Attribute` 'LINE_ITEM_TYPE' | 'SERVICE', required — The attribute of the line item filter. This specifies what attribute that you can filter on.
      - `MatchOption` 'NOT_EQUAL' | 'EQUAL', required — The match criteria of the line item filter. This parameter specifies whether not to include the resource value from the billing group total cost.
      - `Values` LineItemFilterValue[] — The values of the line item filter. This specifies the values to filter on. Currently, you can only exclude Savings Plans discounts.
      - `AttributeValues` AttributeValue[] — The values of the line item filter. This specifies the values to filter on.
  - `LastModifiedTime` integer — The most recent time when the custom line item was modified.
  - `AssociationSize` integer — The number of resources that are associated to the custom line item.

## 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)