Update Organization Recharge Policy

PATCH/v1/organizations/{organization_id}/billing/recharge_policy

Update the organization’s recharge mode: manual for self-serve top-ups, or automatic to charge the card on file at the recharge threshold (fixed and proportional required).

Path ParametersExpand Collapse

organization_id: string

Body ParametersJSONExpand Collapse

policy: RechargePolicyMode

Policy is the top-up mode.

One of the following:

"manual"

"automatic"

policy_args: optional AutomaticPolicyArgs { fixed, runway_days, monthly_cap }

PolicyArgs carries the threshold parameters. Required when policy is “automatic”; must be omitted when policy is “manual”.

fixed: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

runway_days: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

monthly_cap: optional string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

ReturnsExpand Collapse

OrganizationRechargePolicy object { policy, policy_args, policy_since }

An organization’s current recharge policy. policy_args is null for a manual policy.

policy: RechargePolicyMode

Policy is the top-up mode.

One of the following:

"manual"

"automatic"

policy_args: AutomaticPolicyArgs { fixed, runway_days, monthly_cap }

PolicyArgs carries the threshold parameters. Required when policy is “automatic”; must be omitted when policy is “manual”.

fixed: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

runway_days: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

monthly_cap: optional string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

policy_since: string

PolicySince is when the policy currently in force took effect. Any change moves it, including an edit to the threshold parameters of an automatic policy.

formatdate-time

Update Organization Recharge Policy

curl https://api.nirvanalabs.io/v1/organizations/$ORGANIZATION_ID/billing/recharge_policy \
    -X PATCH \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY" \
    -d '{
          "policy": "automatic"
        }'

{
  "policy": "automatic",
  "policy_args": {
    "fixed": "-69125",
    "runway_days": "-69125",
    "monthly_cap": "-69125"
  },
  "policy_since": "2026-07-30T12:00:00Z"
}

Returns Examples

{
  "policy": "automatic",
  "policy_args": {
    "fixed": "-69125",
    "runway_days": "-69125",
    "monthly_cap": "-69125"
  },
  "policy_since": "2026-07-30T12:00:00Z"
}