Set the company's spend limits

PATCH

api

settings

billing

usage-controls

Set the company's spend limits

curl --request PATCH \
  --url https://api.fluid.app/api/settings/billing/usage-controls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limits_enabled": true,
  "ai_limit_cents": 150000,
  "studios_limit_cents": 75000,
  "ai_daily_limit_cents": 10000,
  "auto_reload": true,
  "reload_authorization_version": "2026-10-06",
  "auto_reload_threshold_cents": 5000,
  "auto_reload_amount_cents": 20000,
  "shown_reload_threshold_cents": 5000,
  "shown_reload_amount_cents": 20000,
  "shown_reload_daily_cap_cents": 50000,
  "shown_reload_monthly_cap_cents": 500000
}
'

import requests

url = "https://api.fluid.app/api/settings/billing/usage-controls"

payload = {
    "limits_enabled": True,
    "ai_limit_cents": 150000,
    "studios_limit_cents": 75000,
    "ai_daily_limit_cents": 10000,
    "auto_reload": True,
    "reload_authorization_version": "2026-10-06",
    "auto_reload_threshold_cents": 5000,
    "auto_reload_amount_cents": 20000,
    "shown_reload_threshold_cents": 5000,
    "shown_reload_amount_cents": 20000,
    "shown_reload_daily_cap_cents": 50000,
    "shown_reload_monthly_cap_cents": 500000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    limits_enabled: true,
    ai_limit_cents: 150000,
    studios_limit_cents: 75000,
    ai_daily_limit_cents: 10000,
    auto_reload: true,
    reload_authorization_version: '2026-10-06',
    auto_reload_threshold_cents: 5000,
    auto_reload_amount_cents: 20000,
    shown_reload_threshold_cents: 5000,
    shown_reload_amount_cents: 20000,
    shown_reload_daily_cap_cents: 50000,
    shown_reload_monthly_cap_cents: 500000
  })
};

fetch('https://api.fluid.app/api/settings/billing/usage-controls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/settings/billing/usage-controls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'limits_enabled' => true,
    'ai_limit_cents' => 150000,
    'studios_limit_cents' => 75000,
    'ai_daily_limit_cents' => 10000,
    'auto_reload' => true,
    'reload_authorization_version' => '2026-10-06',
    'auto_reload_threshold_cents' => 5000,
    'auto_reload_amount_cents' => 20000,
    'shown_reload_threshold_cents' => 5000,
    'shown_reload_amount_cents' => 20000,
    'shown_reload_daily_cap_cents' => 50000,
    'shown_reload_monthly_cap_cents' => 500000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/settings/billing/usage-controls"

	payload := strings.NewReader("{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/settings/billing/usage-controls")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/settings/billing/usage-controls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}"

response = http.request(request)
puts response.read_body

{
  "usage_controls": {
    "limits_enabled": true,
    "auto_reload": true,
    "reload_caps": {
      "daily_cents": 50000,
      "monthly_cents": 500000
    },
    "limits": {
      "orders": null,
      "ai": 150000,
      "hosting": null,
      "studios": 75000
    },
    "daily_limits": {
      "ai": 10000,
      "studios": null
    },
    "reload_threshold_cents": 5000,
    "reload_amount_cents": 20000,
    "reload_authorized": true,
    "reload_authorization_current": true,
    "reload_authorization": {
      "version": "2026-10-06",
      "text": "You authorize Fluid to charge the card or debit the bank account on file for the reload amount you set whenever your usage credits fall below your threshold, up to your daily and monthly reload limits. Each reload is a purchase of usage credits on the purchase terms. You can turn auto-reload off at any time. A declined or returned reload pauses further reloads until you change your payment method or turn auto-reload off and on again. A reload charged to a credit card can carry a processing fee that Fluid sets for your account: a percentage of the reload amount, which can have a cap, shown on your billing page and charged with the reload. Debit cards and prepaid cards carry no fee."
    },
    "reload_block": null,
    "reload_cap_reached": null,
    "reload_held_because": null
  },
  "status": 200,
  "meta": {
    "request_id": "f3b8c2d1-6a4e-4f7b-9c1d-2e5a8b7c4d90",
    "timestamp": "2026-09-30T14:05:11Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Body

application/json

limits_enabled

boolean

Whether the monthly spend limits are on.

auto_reload

boolean

Whether a low balance reloads itself; turning it on needs reload_authorization_version.

reload_authorization_version

string

The auto-reload authorization version the merchant was shown and accepts.

auto_reload_threshold_cents

integer | null

Reload below this spendable balance

Required range: x >= 1

auto_reload_amount_cents

integer | null

What one reload buys

Required range: x >= 1

orders_limit_cents

integer | null

Orders and checkout; notified

Required range: x >= 1

ai_limit_cents

integer | null

Monthly ceiling on AI

Required range: x >= 1

hosting_limit_cents

integer | null

Apps

Required range: x >= 1

studios_limit_cents

integer | null

Monthly ceiling on Fluid Studios

Required range: x >= 1

ai_daily_limit_cents

integer | null

Daily ceiling on AI

Required range: x >= 1

studios_daily_limit_cents

integer | null

Daily ceiling on Fluid Studios

Required range: x >= 1

auto_reload_daily_cap_cents

integer | null

The most auto-reload tops up in a day; null is Fluid's default.

Required range: x >= 1

auto_reload_monthly_cap_cents

integer | null

The most auto-reload tops up in a month; null is Fluid's default.

Required range: x >= 1

shown_reload_threshold_cents

integer

The reload threshold the merchant was shown with the consent, as reload_threshold_cents reads it. Sent with a save that turns auto-reload on or renews its consent; if the threshold the save would store differs, the save is refused with 409 usage_controls_changed. A renewal renews the consent only when it sends all four shown_reload_* figures: with none, the old consent stays and the rest of the save applies; with only some, the save is refused with 422. Left out of a first turn-on, it is not checked.

Required range: x >= 1

shown_reload_amount_cents

integer

The reload amount shown with the consent, as reload_amount_cents reads it; checked like shown_reload_threshold_cents.

Required range: x >= 1

shown_reload_daily_cap_cents

integer

The daily reload cap shown with the consent, as reload_caps.daily_cents reads it; checked like shown_reload_threshold_cents.

Required range: x >= 1

shown_reload_monthly_cap_cents

integer

The monthly reload cap shown with the consent, as reload_caps.monthly_cents reads it; checked like shown_reload_threshold_cents.

Required range: x >= 1

Response

Success

The merchant's spend limits and auto-reload.

usage_controls

object

required

What the merchant has set about its own usage: spend limits, and auto-reload, which buys the reload amount with the payment method on file when the spendable balance falls below the threshold, within the reload caps, and only with its authorization on record.

Show child attributes

Set the company's spend limits

curl --request PATCH \
  --url https://api.fluid.app/api/settings/billing/usage-controls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "limits_enabled": true,
  "ai_limit_cents": 150000,
  "studios_limit_cents": 75000,
  "ai_daily_limit_cents": 10000,
  "auto_reload": true,
  "reload_authorization_version": "2026-10-06",
  "auto_reload_threshold_cents": 5000,
  "auto_reload_amount_cents": 20000,
  "shown_reload_threshold_cents": 5000,
  "shown_reload_amount_cents": 20000,
  "shown_reload_daily_cap_cents": 50000,
  "shown_reload_monthly_cap_cents": 500000
}
'

import requests

url = "https://api.fluid.app/api/settings/billing/usage-controls"

payload = {
    "limits_enabled": True,
    "ai_limit_cents": 150000,
    "studios_limit_cents": 75000,
    "ai_daily_limit_cents": 10000,
    "auto_reload": True,
    "reload_authorization_version": "2026-10-06",
    "auto_reload_threshold_cents": 5000,
    "auto_reload_amount_cents": 20000,
    "shown_reload_threshold_cents": 5000,
    "shown_reload_amount_cents": 20000,
    "shown_reload_daily_cap_cents": 50000,
    "shown_reload_monthly_cap_cents": 500000
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    limits_enabled: true,
    ai_limit_cents: 150000,
    studios_limit_cents: 75000,
    ai_daily_limit_cents: 10000,
    auto_reload: true,
    reload_authorization_version: '2026-10-06',
    auto_reload_threshold_cents: 5000,
    auto_reload_amount_cents: 20000,
    shown_reload_threshold_cents: 5000,
    shown_reload_amount_cents: 20000,
    shown_reload_daily_cap_cents: 50000,
    shown_reload_monthly_cap_cents: 500000
  })
};

fetch('https://api.fluid.app/api/settings/billing/usage-controls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/settings/billing/usage-controls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'limits_enabled' => true,
    'ai_limit_cents' => 150000,
    'studios_limit_cents' => 75000,
    'ai_daily_limit_cents' => 10000,
    'auto_reload' => true,
    'reload_authorization_version' => '2026-10-06',
    'auto_reload_threshold_cents' => 5000,
    'auto_reload_amount_cents' => 20000,
    'shown_reload_threshold_cents' => 5000,
    'shown_reload_amount_cents' => 20000,
    'shown_reload_daily_cap_cents' => 50000,
    'shown_reload_monthly_cap_cents' => 500000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/settings/billing/usage-controls"

	payload := strings.NewReader("{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.fluid.app/api/settings/billing/usage-controls")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/settings/billing/usage-controls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"limits_enabled\": true,\n  \"ai_limit_cents\": 150000,\n  \"studios_limit_cents\": 75000,\n  \"ai_daily_limit_cents\": 10000,\n  \"auto_reload\": true,\n  \"reload_authorization_version\": \"2026-10-06\",\n  \"auto_reload_threshold_cents\": 5000,\n  \"auto_reload_amount_cents\": 20000,\n  \"shown_reload_threshold_cents\": 5000,\n  \"shown_reload_amount_cents\": 20000,\n  \"shown_reload_daily_cap_cents\": 50000,\n  \"shown_reload_monthly_cap_cents\": 500000\n}"

response = http.request(request)
puts response.read_body

{
  "usage_controls": {
    "limits_enabled": true,
    "auto_reload": true,
    "reload_caps": {
      "daily_cents": 50000,
      "monthly_cents": 500000
    },
    "limits": {
      "orders": null,
      "ai": 150000,
      "hosting": null,
      "studios": 75000
    },
    "daily_limits": {
      "ai": 10000,
      "studios": null
    },
    "reload_threshold_cents": 5000,
    "reload_amount_cents": 20000,
    "reload_authorized": true,
    "reload_authorization_current": true,
    "reload_authorization": {
      "version": "2026-10-06",
      "text": "You authorize Fluid to charge the card or debit the bank account on file for the reload amount you set whenever your usage credits fall below your threshold, up to your daily and monthly reload limits. Each reload is a purchase of usage credits on the purchase terms. You can turn auto-reload off at any time. A declined or returned reload pauses further reloads until you change your payment method or turn auto-reload off and on again. A reload charged to a credit card can carry a processing fee that Fluid sets for your account: a percentage of the reload amount, which can have a cap, shown on your billing page and charged with the reload. Debit cards and prepaid cards carry no fee."
    },
    "reload_block": null,
    "reload_cap_reached": null,
    "reload_held_because": null
  },
  "status": 200,
  "meta": {
    "request_id": "f3b8c2d1-6a4e-4f7b-9c1d-2e5a8b7c4d90",
    "timestamp": "2026-09-30T14:05:11Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Member API

Member Sites APIs

Messaging

Cowork

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Set the company's spend limits

Authorizations

Body

Response