For each Project, it is possible to configure quota limits to control the Project expenses or usage.
To access and configure quota limits, you must have the Organization Administrator (Organization Member) role. This means you must be listed under Members in the Organization Options section.
To manage quota limits, follow the steps below:
1. Enter the Console. On the left side of the screen, you can find the Console Menu. In this menu, under the group of options called ORGANIZATION OPTIONS you will find the Projects section, where you can manage quota limits for each Project.
2. Select the desired Project and click on USAGE LIMITS.
When you enter the installments section, you will see a screen with the following information for each quota:
- Valid until: Expiration date and time of the quota.
- Status: Projects can operate with or without defined quotas. If no quotas are defined, the status is No Limits, meaning there are no restrictions on consumption. However, once a quota is defined, this status cannot be reverted.
When quotas are defined, the Project can transition into one of the following statuses:
- Active: Indicates that the quota is in use and has an available balance. This quota is highlighted in green. Only one quota can be active at a time in a Project.
- Expired: This status is displayed when a quota period definition has reached its end date. If it was marked as renewable, a new registry will be available as Active on the next renewal date. However, if it is not marked as renewable, the Project will need a new limit definition to continue operating.
- Empty: This status occurs when the Hard limit of an active quota has been reached, exhausting the available balance. The quota remains in green and is highlighted as active but with a full usage balance. If the quota is marked as renewable, the balance will be automatically restored at renewal time.
- Cancelled: If a quota has been manually cancelled, it appears with an orange dot. This indicates that you have voluntarily removed the usage restriction to create a new one, or simply that you no longer want it to be active in the Project.
- Type: Type of quota, which can be daily, weekly, monthly, or Freemium.
By choosing Freemium, a one-time or trial usage quota is established, with a specific limit of requests or costs and no expiration date. This means that the quota is non-renewable and only allows limited access to the service.
- Renewable?: Indicates whether the quota is renewable at the end of its term. If this option is enabled (marked with a check), the quota is automatically renewed when it reaches its expiration date or when the available balance is exhausted (Empty status). If the quota is not renewable (no check), the Project will require a new quota to be defined manually once the current quota has expired or its balance has been exhausted.
- Unit: Unit of measure, which can be Requests, Cost (USD), or Tokens.
- Hard limit alert: Defines the threshold value configured for the quota.
- Remaining: Available balance remaining for the quota.
To create a new quota limit, follow these steps:
- Click the CREATE NEW button on the quota management screen. This will open a configuration window.
- Complete the configuration fields according to the required values, such as subscription type, unit of measure, alert limits, and renewal option.
If you select Freemium as the subscription type, the Renewable? option will not be available. This is because Freemium represents a one-time usage or trial limit with no possibility of automatic renewal.
If the Organization has an active quota, the Unit and the subscription type of the Project quota must match the ones defined for the Organization. Because Organizations are measured only in Cost (USD) or Tokens, Requests cannot be selected while the Organization has an active quota.
- Click on CONFIRM to save the quota limit, or CANCEL to discard the changes.
In the quotas screen, you can perform the following actions on active quotas:
- UPDATE: Allows you to modify parameters of the active quota, such as soft limit, enable or disable renewal, and increase the hard limit. If an active quota runs out of balance but is renewable, you can increase the hard limit to restore the balance without creating a new quota.
- CANCEL: This option allows you to cancel the active quota, making it possible to define a new limit instead. This is useful when you want to completely modify the usage restrictions for the Project.
If the Status of an active and renewable quota changes to Empty due to depletion of its balance, you can restore its availability by increasing the Hard limit using the UPDATE action.
When a Project has no quota defined and its Organization has an active quota, the Project consumes against the Organization balance. See Organization Usage Limits.
Every request must pass both the Project check and the Organization check.
The Organization limit applies to the real combined consumption of all its Projects. A Project quota is an individual maximum, not a guarantee of availability. A request can be blocked by the Organization limit even when the Project still shows remaining balance.
When the Organization has an active quota, Project quotas must stay consistent with it:
- The Project Unit must be the same as the Organization Unit.
- The Project Type must be the same as the Organization subscription type, so both renew on the same schedule.
If a Project quota does not match, the platform blocks the definition of the Organization limit and shows an alert listing the affected Projects. You must change or cancel those Project quotas before the Organization limit can be defined.
Cancelling a Project quota does not return consumed usage to the Organization. The usage already consumed stays counted at Organization level.