---
title: "Patch charge key limit caps"
method: PATCH
path: "/api/v1/charge-key-limit-caps/{chargeKeyLimitCapId}"
tags: ["Charge Key Limit Caps"]
---

# Patch charge key limit caps

`PATCH /api/v1/charge-key-limit-caps/{chargeKeyLimitCapId}`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/charge-key-limit-caps/{chargeKeyLimitCapId}`
- Auth: HTTP bearer

Required scope: `charge-key-limit-caps:write` (not requestable by marketplace apps) </br>Organization authorization: `supported`

An operator has one set of caps per team settings profile (Hub: Operator team settings); `defaultForTeamType` says which teams get the set by default. A charge key's own usage limits (`rollingSpendLimit`, `dailyChargeCountLimit`, `concurrentChargesLimit`) may not exceed the caps its team is bound by. A `null` cap is not configured, so the `recommended` value is the cap. Caps may not exceed `max`, Monta's ceiling.

Raise a cap here before raising charge keys above it. Only operator-scoped consumers may change caps; a team-scoped consumer gets `403`. Existing charge keys keep their limits when a cap changes.

## Path parameters

- `chargeKeyLimitCapId` integer, required

## Request body

- PatchChargeKeyLimitCap
  - `rollingSpendLimit` number, nullable: Cap on a charge key's rolling 30-day spend, as a plain decimal amount in the currency of `rollingSpendLimit` on read (currently always EUR). Send `null` to remove the cap (the recommended value then applies); omit the field to leave it unchanged. Must be strictly positive and may not exceed `max`.
  - `dailyChargeCountLimit` integer, nullable: Cap on a charge key's daily charge count. Send `null` to remove the cap; omit the field to leave it unchanged. Must be strictly positive and may not exceed `max`.
  - `concurrentChargesLimit` integer, nullable: Cap on a charge key's concurrent charges. Send `null` to remove the cap; omit the field to leave it unchanged. Must be strictly positive and may not exceed `max`.

## Response `200`

Charge key limit caps updated

- ChargeKeyLimitCap: A set of charge key usage limit caps: the highest usage limits a charge key may be given. An operator has one set per team settings profile (Hub: Operator team settings), and a charge key is bound by the set of the profile its team uses.
  - `id` integer: Id of this set of caps
  - `operatorId` integer: Id of the operator these caps belong to
  - `name` string, nullable: Name of the team settings profile, as shown in the Hub
  - `defaultForTeamType` string, nullable: Teams of this type get these caps by default: `professional`, `private`, `all`, `operator`, `default_private_team`, `none`, or `null` when the caps apply only to teams assigned to the profile explicitly. Also sets which `recommended` and `max` values apply.
  - `rollingSpendLimit` Money
    - `amount` integer, required: The amount of money
    - `currency` Currency1, required
      - `id` integer, nullable: id of the currency
      - `master` boolean: Whether the currency is master or not, master meaning the default currency
      - `identifier` string, required: 3 characters identifier
      - `name` string: Name of the currency
      - `decimals` integer, required: How many decimals the currency has
    - `locale` string, required: Current user locale
  - `dailyChargeCountLimit` integer, nullable: Cap on a charge key's daily charge count. `null` means no cap is configured, so `recommended` applies.
  - `concurrentChargesLimit` integer, nullable: Cap on a charge key's concurrent charges. `null` means no cap is configured, so `recommended` applies.
  - `recommended` ChargeKeyLimitValues, required
    - `rollingSpendLimit` Money
      - `amount` integer, required: The amount of money
      - `currency` Currency1, required
        - `id` integer, nullable: id of the currency
        - `master` boolean: Whether the currency is master or not, master meaning the default currency
        - `identifier` string, required: 3 characters identifier
        - `name` string: Name of the currency
        - `decimals` integer, required: How many decimals the currency has
      - `locale` string, required: Current user locale
    - `dailyChargeCountLimit` integer, nullable: Daily charge count limit
    - `concurrentChargesLimit` integer, nullable: Concurrent charges limit
  - `max` ChargeKeyLimitValues, required
    - `rollingSpendLimit` Money
      - `amount` integer, required: The amount of money
      - `currency` Currency1, required
        - `id` integer, nullable: id of the currency
        - `master` boolean: Whether the currency is master or not, master meaning the default currency
        - `identifier` string, required: 3 characters identifier
        - `name` string: Name of the currency
        - `decimals` integer, required: How many decimals the currency has
      - `locale` string, required: Current user locale
    - `dailyChargeCountLimit` integer, nullable: Daily charge count limit
    - `concurrentChargesLimit` integer, nullable: Concurrent charges limit

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/charge-key-limit-caps/:chargeKeyLimitCapId/patch.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)