Overview

Limit Tags are free form, custom strings that are assigned to limit objects. A limit can have any number of tags. Limit Tags can be used to associate your AI costs with categories of users (e.g., free, premium, enterprise), or groups of users, such as departments, customer segments, or specific accounts (e.g., Marketing, DevOps, EnterpriseAccount3).

Limit Tags may contain alphanumeric and underscore characters.

If a request is made with any limit-ids, the costs associated with that request are automatically associated with all tags on the provided limit-ids, and are viewable and pivotable in the Pay-i dashboard.

What Are Limit Tags?

Limit Tags provide a flexible way to categorize and organize your limits based on your business needs. They function as metadata attached to limit objects, enabling you to:

Group related limits together
Categorize costs across different business units
Track usage patterns by department, project, or customer segment
Create hierarchical organizations of limits

Tags work as a many-to-many relationship system - a single limit can have multiple tags, and a single tag can be applied to multiple limits.

Common Use Cases for Limit Tags

Organizational Structure Mapping

Use tags to map your limits to your company's organizational structure:

Department tags: marketing, engineering, sales
Team tags: frontend_team, data_science, customer_success
Project tags: website_redesign, product_launch_q2

Customer Segmentation

Categorize limits by customer types or segments:

Pricing tier tags: free_tier, premium_tier, enterprise
Customer category tags: smb, mid_market, enterprise_accounts
Industry tags: healthcare, finance, education

Cost Allocation

Use tags to track and allocate costs across different business dimensions:

Budget period tags: q1_2024, q2_2024, annual_2024
Budget source tags: opex, innovation_fund, r_and_d
Financial reporting tags: cost_center_123, project_code_abc

Dashboard Integration

When limits are tagged, all costs associated with those limits will be categorizable by those tags in the Pay-i dashboard. This enables powerful filtering and reporting capabilities, allowing you to:

Filter costs by tag to see spending by department, project, or customer segment
Create custom reports based on specific tag combinations
Track cost trends across different organizational dimensions
Compare resource usage between different tagged categories

Managing Limit Tags

For detailed information on how to manage limit tags using the Python SDK, see Python SDK Limit Tags.