See everything you missed at TailscaleUp.Read the recap →

Check and refill budgets

Last validated:

After you configure per-user spending limits or a team-wide budget, you can check how budgets are being consumed and manually refill depleted buckets.

Prerequisites

Before you begin, ensure you have the following:

  • An Aperture gateway with quotas configured. Refer to the quotas configuration reference for details.
  • Network access to the Aperture gateway URL (default: http://ai).
  • Admin access to inspect organization-wide quota data or refill buckets. Users can check their own quota status in the chat portal.

Check quota status in the web interfaces

Users can open /quotas in the Aperture chat portal to view their personal quota buckets, balances, refill status, and affected models.

Admins can inspect organization-wide quota coverage at /admin/quotas. To inspect or adjust the buckets for a specific user, open /admin/dashboard and select the user.

Refill a quota bucket in the admin dashboard

  1. Open /admin/quotas.
  2. Select the user whose quota you want to change.
  3. Locate the quota bucket and select Adjust balance.
  4. Select Add funds, enter the amount to add, then select Add.

To replace the current balance instead, select Set balance, enter the new balance, then select Set.

Check quota status using the API

Admins can query the GET /api/quotas endpoint to retrieve the current status of all quota buckets:

curl http://ai/api/quotas

The response includes each bucket's name, current balance, capacity, and refill rate.

Refill a quota bucket

Admins can manually add funds to a depleted bucket using the POST /api/quotas/refill endpoint:

curl -X POST http://ai/api/quotas/refill \
  -H "Content-Type: application/json" \
  -d '{"bucket": "daily:alice@example.com", "amount": "$5.00"}'

Replace the bucket value with the name of the bucket to refill. The amount value adds to the current balance up to the bucket's configured capacity. Aperture does not allow the balance to exceed capacity.

Only users with admin access can refill quota buckets.

Next steps