Limits

A project’s plan limits, its own monthly limit, and the AI units it has used this month.

Read limits

GET/v1/projects/{project}/limits

Needs View usage and limits.

{
  "plan": {
    "code": "free",
    "name": "Free",
    "unitsPerMonth": 100000,
    "requestsPerMinute": 20,
    "tokensPerMinute": 40000
  },
  "own": {
    "unitsPerMonth": 50000,
    "updatedBy": "01m3c081d2wj4g63qcr53pa1yh",
    "updatedAt": "2026-09-29T10:15:00Z"
  },
  "month": { "start": "2026-09-01", "used": 4200, "reserved": 120 },
  "minute": { "start": "2026-09-29T10:15:00Z", "requests": 3, "tokens": 12500 }
}
plan.unitsPerMonthinteger

The most AI units the plan allows in a month. In every plan limit, 0 means no limit.

plan.requestsPerMinuteinteger

The most calls the project can send in a minute.

plan.tokensPerMinuteinteger

The most tokens the project’s calls can ask for in a minute: each call’s input, and its max_tokens of output.

ownobject or null

The project’s own limit, or null if it never had one. The lower of it and the plan’s applies. own.unitsPerMonth is null when it was removed, and 0 stops AI for the project.

month.startstring

The first day of this month, in UTC.

month.usedinteger

The AI units calls used this month.

minute.requestsinteger

The calls counted so far in this minute, which started at minute.start.

minute.tokensinteger

The tokens those calls asked for: their input, and their max_tokens of output.

month.reservedinteger

Units set aside for calls in progress. See How a call is checked.

Set the project’s own limit

PUT/v1/projects/{project}/limits

Only a person with Developer access or more can do this, from the console. API keys cannot.

{ "unitsPerMonth": 50000 }
unitsPerMonthinteger or nullRequired

The AI units the project may use each month, from 0 to 1,000,000,000,000. null uses the plan’s limit again.

The answer is the project’s limits, as above.

Last updated