# Upsert price-book rows

> Upserts price rows keyed on (provider, model, effective_from). Admin only. `effective_from` must be in the future once the (provider, model, component) is priced — past prices are immutable so recorded costs stay explainable; ship corrections as new future-dated rows. A first price, with no row in this scope or any broader one, may be dated now or earlier.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Upsert price-book rows"}
>
</Heading>

<MethodEndpoint
  method={"put"}
  path={"/api/v1/usage/prices"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Upserts price rows keyed on (provider, model, effective_from). Admin only. `effective_from` must be in the future once the (provider, model, component) is priced — past prices are immutable so recorded costs stay explainable; ship corrections as new future-dated rows. A first price, with no row in this scope or any broader one, may be dated now or earlier.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./upsert-price-book.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./upsert-price-book.StatusCodes.json")}
>
  
</StatusCodes>