# updateRate (https://developer.godaddy.com/en/docs/references/rest/taxes/rate/mutations/updateRate)

***

title: updateRate
description: "Update an existing rate."
full: true
----------

mutation

Requires `commerce.tax:write`.

Update an existing rate.

For `SimpleMoneyInput.value`, send `1999` for $19.99 USD, not `19.99`.

## Required headers

| Header       | Required | Description                                                                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `x-store-id` | Yes      | ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`. |

Go to [Authentication](https://developer.godaddy.com/docs/api-users/auth) for credential setup.

## Arguments

* `id` `ID!` **required**
* `input` `MutationUpdateRateInput!` **required**
  * `calculationMethod` `RateCalculationMethodEnum` **optional** — The method to be used when applying the rate to a purchase amount.
  * `createdAt` `DateTime` **optional** — WARNING: DO NOT USE. Deprecated: This field is deprecated and only used for Tax v1 to v2 migration syncs.
  * `description` `String` **optional** — A human-friendly description.
  * `jurisdictionId` `ID` **optional** — The ID of the jurisdiction in which this rate applies.
  * `label` `String` **optional** — A label for display.
  * `name` `String` **optional** — A unique human-friendly identifier.
  * `status` `RateStatusEnum` **optional** — The desired status.
  * `updatedAt` `DateTime` **optional** — WARNING: DO NOT USE. Deprecated: This field is deprecated and only used for Tax v1 to v2 migration syncs.
  * `value` `RateValueInput` **optional** — The rate's value.
    * `amount` `SimpleMoneyInput` **optional** — The rate value represented as a fixed money amount. Required if `percentage` is not provided.
    * `percentage` `String` **optional** — The percentage applied by the rate, out of 100. Required if `amount` is not provided.

## Possible returns

* `Rate` `Rate` — An individual tax rate.

- `activatedAt` `DateTime` **nullable** — The data & time at which the rate was first activated.
- `calculationMethod` `RateCalculationMethodEnum!` **non-null** — The method to be used when applying the rate to a purchase amount.
- `classifications` `RateClassificationsConnection` **nullable** — The classifications associated with the rate.
- `createdAt` `DateTime!` **non-null** — The data & time at which the rate was created.
- `description` `String` **nullable** — The human-friendly description.
- `id` `ID!` **non-null** — The globally-unique ID.
- `jurisdiction` `Jurisdiction` **nullable** — The jurisdiction in which this rate applies.
- `label` `String!` **non-null** — The label for display.
- `metafields` `RateMetafieldsConnection` **nullable**
- `name` `String!` **non-null** — The unique human-friendly identifier.
- `references` `RateReferencesConnection` **nullable** — A reference to the resource in an external service.
- `status` `RateStatusEnum!` **non-null** — The current status.
- `updatedAt` `DateTime!` **non-null** — The data & time at which the rate was last updated.
- `value` `RateValue!` **non-null** — The rate's value