Get / Update Settings

Get and update auto top-up billing settings via /v1/billing/settings. A human enables auto top-up once; agents then maintain the credit balance autonomously.

The billing settings endpoints (GET and PATCH /v1/billing/settings) control whether AI agents can autonomously top up credits on your Talonic account. Auto top-up means an agent may call POST /v1/billing/topup to add a preconfigured number of credits whenever the balance falls below a threshold. A human must enable it and configure the threshold and amount before agents can use the top-up endpoint.

The auto top-up system is designed with a human-in-the-loop safety model. An organization admin enables it once with a threshold and amount, and from that point agents can autonomously maintain the credit balance without further human intervention.

• Read current settings with GET /v1/billing/settings.
• Enable auto top-up and set threshold/amount with PATCH /v1/billing/settings.
• Only users with write scope can modify settings — agents cannot enable auto top-up themselves.

Response

{
  "auto_topup_enabled": false,
  "auto_topup_threshold": 5000,
  "auto_topup_amount": 50000,
  "min_threshold": 1000,
  "min_amount": 1000,
  "max_amount": 500000
}

Errors

Response

The PATCH response returns the full merged settings object, including the platform limits, so a client can confirm the applied configuration in one round trip.

{
  "auto_topup_enabled": true,
  "auto_topup_threshold": 5000,
  "auto_topup_amount": 50000,
  "min_threshold": 1000,
  "min_amount": 1000,
  "max_amount": 500000
}

Errors