# Update Usage Limit
source: https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/usage-limits-management/update-usage-limit/index.md

## Overview {#overview}

The use case describes how you update the usage limit configured during the onboarding process.

## Sequence diagram {#sequence-diagram}

Diagram update-usage-limit

### Explanation {#explanation}

1. The server sends a `PUT` request to the `/contracts/{contract_id}/usage-limits/{usage_limit_code}` endpoint.  
   To update the default values of the usage limit defined during the onboarding process, the server must send one of the optional fields `currency`, `maxAmount`, `maxNumber`, `maxPercent`, or `maxSingleAmount`.  
   To update the usage limit on the account contract or card contract level, the server must put the `accountContractId` or `cardContractId`, respectively, in place of the `contract_id` in the path. Note: Possible values for the `usage_limit_code` parameter are defined during the onboarding process. Refer to [Usage Limits](https://developer.mastercard.com/mastercard-processing-core/documentation/guides/usage-limits/index.md) for more information.
2. The API returns the HTTP status `204`.

Refer to the [Enable or disable usage limit](https://developer.mastercard.com/mastercard-processing-core/documentation/use-cases/usage-limits-management/enable-disable-usage-limit/index.md) use case to change status of the usage limit.
Refer to [Sandbox testing](https://developer.mastercard.com/mastercard-processing-core/documentation/sandbox-testing/usage-limits-management/update-usage-limit/index.md) for information on how to execute the use case in the Sandbox environment.

## Endpoint {#endpoint}


API Reference: `PUT /contracts/{contract_id}/usage-limits/{usage_limit_code}`

