Account limits and quotas: what they are and how to raise them

1. Why limits?

Limits protect your account: a leaked API key or a faulty script cannot open hundreds of servers and drain your balance. New accounts get a lower limit in their first days. If you really need more, we raise the limit on request.

2. Default limits

If a limit was raised for you, the effective value always shows in the list in the next section.

3. See your limits and usage

gyro CLI:

gyro limits

The output starts with the new-account limit (e.g. "Istanbul servers 2/5"), then every limit with its maximum, your usage and how to raise it. * marks a limit changed for your account.

API: GET /api/v1/client/cloud/account/limits (the cloud_read scope is enough). The answer has new_account (new-account limit and when it ends) and the limits list (key, limit, used, how_to_increase).

Terraform: the data "gyro_account_limits" "this" {} data source returns the same list; use it in a precondition to stop a plan that would go over a limit before anything is applied.

4. When you hit a limit

The client area, API, CLI and Terraform give the same explanation: which limit, its value, your usage and how to raise it. Sample CLI output:

Error: New accounts can run at most 5 Istanbul cloud servers during the first 7 days (you have 5). Please contact support to raise the limit.
  (code: limit_exceeded, HTTP 422)
  To raise the limit: gyro ticket create --department-id 3 --subject "Limit increase: new_account.servers" --message "..."
  All limits and usage: gyro limits

In the API answer error.details holds limit_exceeded: true, limit_key, limit, current, how_to_increase and a ready ticket request (support_ticket). A price quote (dry_run) warns in advance with quote.limit_exceeded; the CLI then stops without asking for confirmation.

5. Raise a limit (support ticket)

1. In the client area open Support > New ticket and choose the Order department.
2. Put the limit in the subject (e.g. "Limit increase: new_account.servers").
3. In the message, write the new value you need and briefly what you are building.

The same ticket from a terminal or a script:

gyro ticket create --department-id 3 \
  --subject "Limit increase: new_account.servers" \
  --message "Requested limit: 10. Reason: staging and production cluster."

API: POST /api/v1/client/tickets with {"department_id": 3, "subject": "...", "message": "..."} (the key needs the Tickets/CreateTicket scope). An AI agent can open it too: the support_ticket field of the error is a filled-in request.

6. Frequently asked questions