Update provider limit policy

PATCH
/providers/{providerID}/limits

Update your provider’s default limit policy.

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

Request
cURL
curl -X PATCH https://api.moov.money/providers/{providerID}/limits
Responses
200 400 401 403 409 422
The request completed successfully.
{
  "policy": {
    "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"
    },
    "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.
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.

Request

application/json
A partial update to the provider default policy: present dimensions change, absent leave unchanged, explicit null clears to inherit. Send expectedVersionID from your latest read; omit only on bootstrap (first write for a provider with no policy yet).

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.

expectedVersionID

string
The versionID from your latest read; omit only on bootstrap. A stale value returns 409 version_conflict.

Response

Response envelope for the provider limit policy; the policy is nested under policy.

policy

object required
The provider default limit policy.
Show child attributes

policy

perTransactionAmount

object
Per-send amount ceiling.
Show child attributes

policy.perTransactionAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

policy.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

policy.dailyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

policy.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

policy.weeklyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

policy.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

policy.monthlyAmount

currency

object required
ISO 4217 currency descriptor.
Show child attributes

policy.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.

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.

currency

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