Organizations & Tenancy
AVAILABLEIn Naagmani, the Organization represents the highest-level entity in the tenant hierarchy. It serves as the administrative, billing, and governance container for an enterprise or development team.
Rendering diagram...
graph TD
Org["Organization (Acme Corp)"]
Org --> P1["Project: E-Commerce Search"]
Org --> P2["Project: Internal Copilot"]
Org --> PortalUsers["Portal Users (Human RBAC)"]
Org --> Roles["Dynamic Organization Roles & Permissions"]
Org --> Bgt["Organization Budget Cap"]
Org --> Vault["BYOK Encrypted Credential Vault"]
P1 --> CM1["Customer Members (Project Scoped)"]
P1 --> PST1["Project Service Tokens"]
P2 --> CM2["Customer Members (Project Scoped)"]
P2 --> PST2["Project Service Tokens"]
Key Responsibilities of an Organization #
- Billing & Budget Authority: Governs the root spending limit for all underlying projects and customer members. Project and Customer Member limits can never exceed the Organization's limit.
- Team & Portal User Access: Manage Developer Portal logins, dynamic role assignments, and organization memberships:
- System Roles: Predefined
Owner,Admin, andMemberplatform roles. - Custom Roles: Tailored roles (e.g.
Project Operator,Billing Manager) composed of granular canonical permissions. - Project Access: Assign portal users to project workspaces via ProjectAccessAssignment.
- System Roles: Predefined
- Bring-Your-Own-Key (BYOK) Vault: Store root provider API keys (OpenAI, Anthropic, Gemini, DeepSeek) centrally with AES-256-GCM encryption.
- Audit Trail: Aggregated compliance logging capturing every authentication event, key creation, role modification, and high-level routing operation.
Managing in the Developer Portal #
Organizations can be managed directly in the Developer Portal:
- Switch Organizations: Use the top-left Organization dropdown selector in the navigation bar.
- Organization Settings: Navigate to https://console.naagmani.com/organizations to update organization name and view subscription tier.
- Portal Users: Manage team access and roles at https://console.naagmani.com/users.
- Roles & Permissions: Create and configure custom organization roles at https://console.naagmani.com/roles.
- Customer Members: Managed per project workspace at
https://console.naagmani.com/projects/[projectId]/members.
Next Steps #
- Learn about project boundaries: Projects & Workloads
- Manage portal team members: Portal Users
- Customer Members architecture: Customer Members
- Portal Users vs Customer Members: Portal Users vs Customer Members
- Configure custom roles: Roles & Permissions