Quotas

A quota rule caps a measured quantity, such as tokens, requests, images, audio seconds, or spending, over a period. Quotas belong to your account, not a workspace, so there is no workspace_id. Reads need quotas:read and writes need quotas:write. Quotas cannot be created through the API. There is no POST /api/v1/quotas.

List quotas

GET /api/v1/quotas

curl 'https://app.nemu.cc/api/v1/quotas' \
  -H 'Authorization: Bearer <access_token>'

const quotas = await nemu.quotas.list();

{
  "data": [
    {
      "id": "qta_1",
      "user_id": "3f0e...",
      "name": "daily_tokens",
      "type": "DAILY_TOTAL_TOKENS",
      "limit": 1000000,
      "period": "ROLLING",
      "enabled": true,
      "model_id": null,
      "model": null,
      "current_usage": 320,
      "is_system": false,
      "created_at": "2026-01-04T10:22:00.000Z",
      "updated_at": "2026-01-04T10:22:00.000Z"
    }
  ],
  "total": 1
}

string

ROLLING for a sliding window, or CALENDAR for a fixed window.

integer

The cap for the period. -1 means unlimited.

boolean

true for rules derived from your plan. System rules are read-only, and their id is prefixed with system_.

object

The model the rule applies to, as { id, name, display_name }, or null when the rule applies to the whole account.

Rule types

A rule’s type names what is being measured and over what period.

Prefix	Period
`DAILY_`	The current day
`MONTHLY_`	The current month
`TOTAL_`	The lifetime of the account

Each prefix combines with a measure: INPUT_TOKENS, OUTPUT_TOKENS, TOTAL_TOKENS, CACHE_INPUT_TOKENS, CACHE_OUTPUT_TOKENS, CACHE_TOTAL_TOKENS (CACHE_TOKENS on TOTAL_), REQUESTS, IMAGES, AUDIO_SECONDS, and SPENDING. DAILY_SEARCHES and DAILY_DEEP_SEARCHES are also available. System rules additionally report RATE_LIMIT_PER_MINUTE, MAX_PROVIDERS, MAX_QUOTA_RULES, and MAX_MODELS. Those types appear only when is_system is true.

Get a quota

GET /api/v1/quotas/{id}

Update a quota

PATCH /api/v1/quotas/{id}

PATCH is a full replace. name, type, limit, and model_id are required on every update. Updating a system_ rule returns 403.

string

required

4 to 32 characters, letters, numbers, and underscores only. Stored lowercased.

string

required

One of the rule types above.

integer

required

Between -1 and 999000000. -1 means unlimited.

string

required

The model the rule applies to.

string

default:"ROLLING"

ROLLING or CALENDAR.

boolean

default:"true"

Whether the rule is enforced.

await quota.update({
  name: "daily_tokens",
  type: "DAILY_TOTAL_TOKENS",
  limit: 2000000,
  model_id: model.id,
});

Delete a quota

DELETE /api/v1/quotas/{id}

Deleting a system_ rule returns 403.

Get started

Setup

API reference

List quotas

Rule types

Get a quota

Update a quota

Delete a quota

​List quotas

​Rule types

​Get a quota

​Update a quota

​Delete a quota

List quotas

Rule types

Get a quota

Update a quota

Delete a quota