For the complete documentation index, see llms.txt. This page is also available as Markdown.

Accounts

Create accounts, set credit limits, and receive usage threshold alerts.

Accounts divide a tenant's Qore platform usage into separately billed units. Each account has its own credit limits and alerts.

Topic
Details
Outcome

Access

Super admins can manage tenant accounts at /platform/super-admin-settings/accounts.

Keep tenant usage organized.

Account management

Create accounts, change account names, and find accounts by name or status.

Maintain named accounts.

Access management

Create users, assign roles, and create teams with users.

Manage tenant access.

Usage control

Set limits and alerts for each account.

Cap consumption or receive warning emails.

Overview

Platform-level accounts are managed by super admins. Within an account, super admins can create users, assign roles, and create teams with users.

Each account has tenant-wide scope. It tracks credit usage for platform billing. Super admins can set per-period consumption caps and alerts.

Key concepts

Concept
Meaning
Key details

Account

A billable unit of tenant usage.

Names are unique. Status is currently active. Each account records its creation time, limits, and alerts.

Credit

Qore's consumption unit.

Every agent and model call deducts a whole number of credits. Accounts don't set credit prices or budgets.

Usage limit

A per-account credit cap for a period.

Qore rejects requests that exceed the cap.

Usage alert

An email notification threshold.

Every super admin in the tenant receives an email. Alerts never reject requests.

Duration

An evaluation period.

Choose Daily, Weekly, or Monthly.

Metric type

An alert threshold method.

Choose Absolute Credits or Percentage of Limit.

Periods reset on UTC calendar boundaries. Daily resets at 00:00 UTC. Weekly resets at 00:00 UTC on Monday. Monthly resets at 00:00 UTC on the first day.

Percentage of Limit uses the account's usage limit with the same duration.

Find and manage accounts

The account directory lists every tenant account. It shows each account's name, creation time, status, and management options. Newer accounts appear first.

When no account matches the query and status, Qore shows No results.. Clear the query or reset the status to restore accounts.

Create an account

Create an account to separate a workload's credit consumption.

1

Start account creation

From the account directory, begin account creation.

2

Provide a name

Enter a unique tenant-wide display name. You can't save an empty name.

3

Save the account

Save the account.

Qore adds the account with active status and a creation timestamp. New accounts have no limits or alerts. Until you add limits, only platform-level limits apply.

Rename an account

Start a rename from the account's management options. Change the existing name, then save it. The name must remain unique within the tenant.

The account keeps its status, creation time, limits, and alerts. Discarding or closing the change keeps the existing name.

Set usage limits

A usage limit caps an account's Qore platform credits during a period. Qore evaluates limits before deducting credits. It rejects a request that would exceed a limit.

Platform-level limits also apply. The stricter limit takes precedence. Adding a limit affects future requests, but credits already consumed count toward the new cap. If usage already exceeds the cap, Qore rejects requests until the period resets.

Accounts have no limits by default. Add a limit to prevent unexpected consumption.

Add a limit

Open the account's management options and start a usage limit. Then provide the required values.

Value
Accepted input
Effect

Duration

Daily, Weekly, or Monthly

Defines the evaluation period. Daily is the default.

Credit limit

A positive integer

Sets the maximum credits for that period.

Save the limit, or discard it. Both values are required.

You can add several limits to an account. Qore evaluates every limit for each request. The strictest applicable limit takes precedence.

Use for unpredictable or burst-heavy workloads. A daily cap bounds consumption for one day.

Use when consumption follows a weekly work pattern.

Use for billing cycles and longer budget horizons.

Combine durations for production workloads. A daily cap protects against spikes. A monthly cap controls total spending.

Set usage alerts

An alert emails every tenant super admin when account usage crosses a threshold. Alerts notify only. Usage limits enforce consumption caps.

Add an alert

Open the account's usage limits and start a new alert. Then set these values:

Value
Accepted input
Effect

Duration

Daily, Weekly, or Monthly

Defines the threshold period. Daily is the default.

Metric type

Absolute Credits or Percentage of Limit

Defines how Qore measures the threshold.

Threshold

Positive integer

Provide a credit count or percentage, based on the metric type.

Save the alert, or discard it. Every value is required.

Enter a positive credit count. Qore sends an email when usage reaches that count. This alert works without a matching usage limit.

Enter a percentage. Set a usage limit with the same duration first. Without one, Qore has no matching limit to measure.

An alert sends at most one email per period. Repeated threshold crossings don't send another email until the period resets. You can add multiple alerts. Qore evaluates each one independently.

Last updated