Overview

Pay-i uses a three-tier hierarchical structure to organize your AI resource management. This structure provides a logical framework that supports everything from individual developers to enterprise teams with complex organizational needs.

Hierarchy

The Pay-i organizational structure consists of three primary levels:

1. Organizations - The top-level entity that contains all your Pay-i resources, users, and settings.
2. Groups - Collections of applications within your organization or logical divisions (e.g., "Marketing", "Engineering").
3. Applications - Individual services or systems that make AI provider requests and contain one or more Use Cases.

This hierarchical approach allows for:

• Clear organizational boundaries
• Granular access controls
• Logical grouping of related resources
• Consolidated metrics and insights at each organizational level

Visual Representation

Organization (e.g., "Company XYZ")
├── Group (e.g., "Engineering")
│   ├── Application (e.g., "ContentCreator-Prod")
│   ├── Application (e.g., "ContentCreator-Dev")
│   └── Application (e.g., "DataAnalytics")
└── Group (e.g., "Marketing")
    ├── Application (e.g., "CustomerSupport")
    └── Application (e.g., "MarketingChatbot")

API Key Assignment

Pay-i assigns API keys at the Application level. These API keys are used for two primary purposes:

1. AI provider usage tracking
2. Programmatic interaction with the Pay-i APIs

Each API key uniquely corresponds to a separate application in your Pay-i account. There are no group, organization, or account-level API keys.

This application-level API key assignment ensures:

• Accurate attribution of AI provider usage to specific applications
• Separation of concerns with distinct security boundaries between services
• Independent management of each application's settings and configurations

Note that API keys are not needed for viewing dashboards, analytics, or other consumption activities within the Pay-i platform.

Common Organizational Patterns

Organizations typically structure their Pay-i resources in one of these patterns:

By Department

Organization: Company XYZ
├── Group: Engineering
├── Group: Marketing
├── Group: Customer Support
└── Group: Sales

By Project or Product Line

Organization: Company XYZ
├── Group: Product A
├── Group: Product B
└── Group: Internal Tools

By Environment

Organization: Company XYZ
├── Group: Development
├── Group: Staging
└── Group: Production

Next Steps

Explore each level of the organizational hierarchy in detail:

• Organizations - Understanding the top-level container
• Groups - Managing collections of applications
• Applications - Creating and configuring individual services

This three-tier structure is the foundation of Pay-i's resource management system, providing the flexibility and organization needed to manage AI resources at any scale.