Plans and limits

What each plan includes, and what happens at the limit.

Plans

	Free	Builder	Startup	Enterprise
Price	$0	$20 / month	$200 / month	Custom
Tokens per billing period	60M	1B	10B	Custom
Concurrent sessions	3	10	100	Custom
Resets	Monthly, on your signup day-of-month	Monthly, on your subscription’s billing date	Monthly, on your subscription’s billing date	Per contract

Current prices are on the pricing page. Allowances may change: read the live values from the API instead of hard-coding them.

Concurrent sessions

A session holds a slot from the moment it leaves queued until it reaches a terminal state, including when you cancel it. Queued sessions hold no slot. See Get quota for the fields.

Python

from hai_agents import Client

client = Client()

quota = client.sessions.get_session_quota()
print(quota.available)

Response

{
  "scope": "user",
  "limit": 10,
  "active": 3,
  "available": 7
}

Queued sessions

At the limit, a create doesn’t fail: it returns 201 with status queued, and the session starts on its own. Set queue: false on the create body to get a 429 instead. For batches, fire every task at once, let the platform pace them, and collect results with webhooks.

Python

products = ["Framework 13", "MacBook Air", "ThinkPad X1"]
sessions = [
    client.sessions.create_session(agent="h/web-surfer-flash", messages=f"Check price for {product}")
    for product in products
]

While queued	Behavior
Start	Automatic, oldest first, as slots free up. The session then follows the normal lifecycle (pending, running, terminal) and fires a webhook on every transition.
Messages	Buffered, delivered when the session starts.
Force an answer	Buffered, delivered when the agent starts.
Pause / resume	Unavailable (409).
Cancel	Dequeues it immediately.
Wait limit	A session still queued after 24 hours ends timed_out.
Child sessions	Never queue: a create with parent_session_id fails with 429 at capacity, since a child queued behind its own running parent could wait forever.

Idle sessions make room

At your limit, a new session, a message that restarts a finished one, or a queued session’s start first ends your own sessions that have been idle for at least 120 seconds, longest idle first.

• They end interrupted, with a session.status_updated webhook. A message picks one up again.
• Sessions in any other state, and other users’ sessions, are never ended.
• In the local runtime, a new session at the runtime’s cap ends the longest-idle session right away, and it reads completed.

Token usage

Agents consume tokens as they work. When the period’s allowance runs out, sessions still start: their model calls are billed to your organization’s credit, at model price plus 20%. Add credit from the billing page in the H Platform. With no credit left, the session fails with error_code insufficient_credit (see Session failures). The allowance is checked when a session starts: a session that starts within the allowance stays on it until it ends.

Python

tokens = client.quota.get_token_quota()
print(tokens.remaining)

Response

{
  "limit": 60000000,
  "used": 4200000,
  "remaining": 55800000,
  "window_start": "2026-06-01T00:00:00Z",
  "window_end": "2026-07-01T00:00:00Z"
}

Field	Type	Description
limit	integer | null	Tokens allowed this period. null means unlimited.
used	integer | null	Tokens used so far. null if momentarily unavailable.
remaining	integer | null	max(limit - used, 0).
window_start	string	Start of the current period (UTC).
window_end	string | null	End of the current period (UTC).

Per-organization limits

Resource	Limit	Over the limit
Queued sessions	1000	Creates return 429.
Webhooks	10	Create returns 400.
Schedules	20	Create returns 400.
H-hosted vault items, across all vaults	1000	Create an item returns 403.
Cloud environment starts	10 per minute per user, 20 per minute per organization	Spread larger bursts of session creates over time.

API requests aren’t rate-limited.

Manage your subscription

Start a Builder or Startup subscription from the billing page in the H Platform (card only). Manage your card and invoices through the Stripe billing portal linked from the same page. Cancelling stops the renewal: paid allowances stay active until the end of the current period, then the organization returns to Free.

For higher allowances or an Enterprise plan, contact [e-mail].