Core Concepts
Organizations
Understanding Organizations: The top-level container for your resources in Bluerails.
What is an Organization?
In Bluerails, an Organization represents your business, project, or entity. It acts as the primary, top-level container that holds all of your resources and configurations within the platform.
Think of it as the root for your interactions with Bluerails. Everything you create or manage using our API or Dashboard—such as Accounts, API Keys, Payments, and Payouts—belongs to a specific Organization.
Key Characteristics
- Top-Level Container: All other Bluerails resources are nested under an Organization. This provides structure and hierarchy.
- Data Isolation: Each Organization operates independently. Data and resources within one Organization (e.g., Accounts, transaction history) are completely separate and isolated from those in any other Organization.
- Unique Identification: While you often interact with resources like Accounts directly, your Organization has a unique identifier assigned during creation.
- Creation: Your primary Organization is typically created automatically when you sign up for Bluerails through the Dashboard.
Organizations and Other Resources
- Accounts: An Organization can have multiple Accounts. Each Account holds balances for specific assets (like USDC or EURC) and belongs directly to one Organization.
- API Keys: API keys are scoped to your Organization. When you authenticate API requests using your key, Bluerails automatically identifies which Organization you are acting on behalf of.
- Payments & Payouts: While Payments and Payouts are operations linked directly to specific Accounts, they occur within the context of the Organization that owns those Accounts.
Users
User 1
User 2
...
Organization
Bluerails Org
Accounts
Account 1
Account 2
...