Managing Your Axonius AI Credits

Use the Credit Management page to view credit consumption and distribute credit allocations to users and roles across your organization.

Permissions

To access the Credit Management page, your role needs the Configure AI system settings permission. Any role can have this permission.

Credit Overview

In the AI Companion, one prompt and its reply use one credit. The prompt and the reply don't count as separate credits. Each follow-up message, in the AI Companion or in a worker's conversation, also uses one credit. Each AI Workforce worker run uses three credits.

Users receive a warning when they reach 90% of their allowance and are blocked from using AI tools when they reach 100%. When your organization's credit balance reaches zero, AI usage stops. Axonius doesn't charge for overages.

The Credit Management page displays three summary tiles:

• Promotional credits — The total number of credits in your promotional bucket and its expiry date.
• Allocated — The number of credits distributed to users and roles, and how many remain unallocated.
• Used — The total credits consumed, shown as a percentage of the bucket, and the number of allocated users.

Axonius creates two bucket types: Promotional and Purchased. The system uses Promotional credits first, then the Purchased bucket that expires soonest. Each bucket has an expiry date. Credits are added to a bucket in full when it's created, not monthly, and are used up as your organization consumes them. There is no monthly reset or monthly bill.

The Promotional bucket bar breaks down credit usage into three categories:

• Used — Credits already consumed.
• Allocated, unused — Credits distributed but not yet consumed.
• Unallocated — Credits not yet distributed to any user or role.

Starter Credits

When your organization first enables AI, Axonius grants starter credits one time: the 10 administrators who signed in most recently each receive 25 credits, and the AI Workforce account receives 50 credits.

Distributing Credits by User

Use the Manage by user tab to view and set credit allocations for individual users.

The AI Workforce account appears pinned at the top of the table. It represents organizational AI Workers — workers created with the Run as the AI Workforce option. Credits consumed by those workers count against the AI Workforce allowance. Runs from Axonius built-in workers, featured flows, and the daily digest don't count against this allowance. Built-in worker runs are currently free for a short trial period. If you don't set an allowance for the AI Workforce account, organizational workers are blocked.

Personal custom workers use the owner's credits, not the AI Workforce account's allowance.

The table includes the following columns:

• User — The name or Email address of the user. The AI Workforce account is always pinned at the top.
• Role — The role assigned to the user.
• Promotional Credits — The credit limit set for the user in the promotional bucket. Displays No limit set if no allowance is configured. A user with no allowance is blocked and sees: "You don't have a credit allowance yet. Contact your administrator to request one."
• Promotional usage — A progress bar showing the percentage of allocated credits consumed.
• User status — The user's status: Active, Archived, or Archived with allowance.

Setting a User's Credit Allowance

1. In the Manage By user tab, hover over the user row and click Edit allocation.
2. In the drawer that opens, the Current usage section shows the user's used and remaining credits.
3. Under Promotional credits, enter the allowance for the promotional bucket. The helper text shows the headroom available — the remaining unallocated credits in the bucket. The After change section previews the total credits that will be assigned across all users after you save.
4. Under Purchased usage allowance, in Allocated allowance (credits), enter the credit amount.
5. Click Save.

Removing a User's Credit Allowance

The table has no remove action. To stop a user from using credits:

1. In the Manage By user tab, hover over the user row and click Edit allocation.
2. Clear the Promotional credits and Allocated allowance (credits) fields, or enter 0.
3. Click Save.

The user's unused credits go back to the unallocated balance. The user can't use AI tools until an administrator sets a new allowance.

To remove a user from the table, remove the AI Agents View and interact permission from the user's role, or give the user a role without this permission.

Bulk Distributing Credits to a Role

To give the same Purchased credit allowance to all active users in a role at once:

1. In the Manage By role tab, hover over the role row and click Edit.
2. In the Edit " drawer, select the bucket tab, and then enter a value in Credits per user.
3. To give this amount to the users who already have the role, select Apply the bulk override to all existing users in this role. If you don't select this option, Axonius saves the amount only as the role's default.
4. Click Save. The message Quota distributed appears.

Axonius saves Credits per user as the role's default (the Default Credits column in the Manage By role tab). New users that are created with this role get the default automatically. Existing users who move to this role later don't get it.

Viewing Expired User Buckets

Enable Show expired buckets to include users whose credit buckets have expired in the table.

Viewing Credits by Role

Use the Manage by role tab to see credit totals aggregated by role.

The table includes the following columns:

• Role — The name of the role.
• Users — The number of active users assigned to the role.
• Promotional · used / allowance — Credits consumed out of the total allowance allocated to users in the role.
• Promotional usage — A progress bar showing the percentage of allocated credits consumed. Displays in red when usage exceeds 100%.

Enable Show expired buckets to include roles whose credit buckets have expired in the table.

Exporting Credit Data

To export credit data, click Export CSV at the top right of the table. Axonius downloads a CSV file with the current table data.