Put participant limit override

PUT
/providers/{providerID}/participants/{participantID}/limits

Create or update the limit override for one participant. An override is the most specific layer: it beats the participant’s groups and your provider default.

Auth: API key or bearer token. Scoped to the calling provider.

Request
cURL
curl -X PUT https://api.moov.money/providers/{providerID}/participants/{participantID}/limits
Responses
200 400 401 403 404 409 422
The request completed successfully.
{
  "override": {
    "createdOn": "2026-08-31T12:00:00Z",
    "currency": "USD",
    "dailyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "1000.00"
    },
    "dailySendCount": 10,
    "monthlyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "10000.00"
    },
    "perTransactionAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "500.00"
    },
    "reason": "Support case 12345",
    "reference": "case-12345",
    "versionID": "ver_01HF5J9ZKQT4RXP8M2VYBN3D",
    "weeklyAmount": {
      "currency": {
        "code": "USD",
        "decimalPlaces": 2
      },
      "value": "2500.00"
    }
  }
}
Malformed request: the body or headers failed validation.
Authentication missing, invalid, or insufficient.
Authentication present but the action is forbidden for this principal/claim.
The requested resource was not found.
Returned when a version-producing mutation’s expectedVersionID is stale. The caller re-reads the resource and retries with the current version.
{
  "code": "version_conflict"
}
The request was well-formed but couldn’t be processed (e.g. card declined).

Headers

X-Moov-Version

string
Set this header to the API version being targeted (e.g. v2026.07.00). When omitted, the server applies its default version.

Path parameters

providerID

string required
Your provider account ID.

participantID

string required
The participant’s participantID, or your externalID for them. Both resolve to the same participant.

Request

application/json
A create-or-update write for the participant limit override: present dimensions change, absent leave unchanged, explicit null clears to inherit. Send expectedVersionID from your latest read; omit on the first write.

perTransactionAmount

object | null
Per-send amount ceiling. null clears to inherit.

dailyAmount

object | null
Trailing 24h amount ceiling. null clears to inherit.

weeklyAmount

object | null
Trailing 7d amount ceiling. null clears to inherit.

monthlyAmount

object | null
Trailing 30d amount ceiling. null clears to inherit.

dailySendCount

integer<int64> | null
Trailing 24h send-count ceiling. null clears to inherit.

expiresOn

string<date-time> | null
When the override lapses. null = permanent.

expectedVersionID

string
The versionID from your latest read; omit on first put.

Response

Response envelope for the participant limit override; the override is nested under override.

override

object required
The participant limit override.
Show child attributes

override

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

override.perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

override.perTransactionAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

dailyAmount

object
Trailing 24h amount ceiling.
Show child attributes

override.dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

override.dailyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

weeklyAmount

object
Trailing 7d amount ceiling.
Show child attributes

override.weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

override.weeklyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

monthlyAmount

object
Trailing 30d amount ceiling.
Show child attributes

override.monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

override.monthlyAmount.currency

decimalPlaces

integer<uint8> required
Number of minor-unit decimal places for code. Required.

numericCode

string
ISO 4217 numeric currency code, if known. Informational only.

name

string
Human-readable currency name, if known. Informational only.

code

string required
Uppercase 3-letter ISO 4217 currency code.

value

string required
Decimal amount as a string.

dailySendCount

integer<int64>
Trailing 24h send-count ceiling.

expiresOn

string<date-time>
When the override lapses. null = permanent. Required (within 24 hours) for support overrides.

reason

string
Override reason. Required for support overrides.

reference

string
Support ticket or case reference. Required for support overrides.

versionID

string required
Latest version ID; send this back as expectedVersionID on your next mutation.

createdOn

string<date-time> required
When this version was created.

disabledOn

string<date-time>
When the override was disabled. Set on the version that removes it.

currency

string required
Three-letter ISO 4217 currency the override is denominated in (v1 USD-only).