> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/settings/organization-settings/usage.md).
# Usage
The **Usage** screen in Autify Genesis shows organization-wide AI usage and storage usage.
## About the Usage screen
Click **Settings** in the lower-left corner, then click **Organization** > **Usage** in the left sidebar to open this screen. Switch between the **Credits** tab (**Tokens** for BYOK or on-prem organizations) and the **Storage** tab at the top of the screen.
***
## Storage
The **Storage** tab shows total and per-workspace storage usage broken down by category.
Storage tab
### Organization storage
You can view organization-wide storage usage by category.
| Item | Description |
| ------------- | -------------------------------------------- |
| **Codebases** | Storage capacity used by codebases. |
| **Files** | Storage capacity used by uploaded files. |
| **Total** | Total storage usage across the organization. |
{% hint style="warning" %}
When storage usage approaches or exceeds the limit, a warning appears. When the limit is exceeded, file uploads are disabled, so delete unnecessary files or codebases to free up space.
{% endhint %}
### Workspace breakdown
You can view storage usage per workspace (codebase, files, total).
***
## Credits
The **Credits** tab (**Tokens** for BYOK or on-prem organizations) shows organization-wide AI usage. Organizations in managed mode see credits and request counts. Organizations in BYOK mode see token consumption and request counts instead.
Use the time range dropdown at the top of the tab to switch the reporting period.
| Option | Description |
| ----------------- | ------------------------------------------------------- |
| **Last 7 days** | Aggregated over the last 7 days (UTC). |
| **Last 30 days** | Aggregated over the last 30 days (UTC). |
| **Last 90 days** | Aggregated over the last 90 days (UTC). |
| **Current month** | Aggregated from the start of the month until now (UTC). |
| **Last month** | Aggregated over the previous full month (UTC). |
{% hint style="info" %}
Usage is aggregated in UTC and displayed in local time.
{% endhint %}
Credits tab
### Usage totals
Displays the main usage metric for the selected period together with the request count. In managed mode, the summary separates **AI** and **Sandbox** credit consumption. In BYOK mode, the main total remains tokens.
### Usage over time
Shows a line chart of credit (or token) usage over the selected period. Switch the granularity between **Daily** and **Weekly**.
### Usage breakdown
Click **Breakdown by source**, **Breakdown by workspace**, or **Token mix** to view detailed breakdowns.
| Tab | Description |
| -------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Breakdown by source** | Usage by chat, workflow, and embeddings. |
| **Breakdown by workspace** | Usage by workspace. Click a workspace name to open its detailed usage page. |
| **Token mix** | Breakdown of input, output, cached, and reasoning tokens. Shown only for organizations in BYOK mode. |
Each tab can switch between **Chart** and **Table** views.
Usage breakdown
### Managed credits
For organizations using managed mode, you can see the managed credits granted to your organization listed **per grant**. Each row shows the following values.
| Item | Description |
| ------------- | -------------------------------------- |
| **Granted** | Credits granted in this grant. |
| **Consumed** | Credits consumed from this grant. |
| **Remaining** | Credits still available in this grant. |
When multiple credit allocations exist, credits expiring soonest are consumed first. Expired or fully consumed credits also appear in the history.
{% hint style="info" %}
This section does not appear for organizations in **BYOK mode**. BYOK mode has no concept of managed credit grants. The main usage metric is fixed by organization mode: managed mode shows credits, and BYOK mode shows tokens.
{% endhint %}
### AI usage alerts
By setting a credit usage threshold, you can show a warning banner when the organization's AI consumption exceeds the threshold.
Only **Owners** can change alert settings. **Admins** and **Members** can only view the current settings.
#### Configuring an AI usage alert
1. Enter the number of credits at which a warning should fire in **Credit threshold** (integer, 0 or greater).
2. Enter the number of days to aggregate in **Rolling window (days)** (1 to 365).
3. Click **Save**.
AI usage alert settings
{% hint style="info" %}
**Rolling window (days)** specifies the period of "the last N days, including today." When the total credit usage during this period exceeds the **Credit threshold**, a warning banner appears at the top of the screen.
{% endhint %}
#### Warning banner
When the threshold is exceeded, a warning banner appears at the top of the app. The banner shows the current credit usage and the configured threshold.
* Click **Dismiss** to hide the banner in that browser tab.
* Click **Manage alert settings** to open the alert settings screen.
#### Disabling alerts
To disable alerts, clear the **Credit threshold** field and click **Save**.