Docs
[INTRODUCTION]

Organisations

Every resource within PLTFRMS is tied to an organisation. An organisation acts as a namespace, ensuring that data, resources, and operations are logically grouped and isolated.

This means that everything you create β€” whether it’s invoices, users, or other resources β€” exists within the context of a specific organisation.

Namespacing

Organisations define clear boundaries:

  • Resources are scoped to a single organisation
  • There is no overlap between organisations
  • Access and permissions are enforced at the organisation level

This structure allows you to safely manage multiple environments, clients, or use cases within the same platform.

Sub-organisations

Organisations can be structured hierarchically using sub-organisations.

This is useful for scenarios such as:

  • Resellers managing multiple customers
  • Multi-tenant platforms separating client data
  • Internal structures such as departments or environments

Each sub-organisation operates independently, while still being part of a larger organisational structure.

Why it matters

Using organisations as namespaces provides:

  • Clear separation of data
  • Scalable multi-tenant architecture
  • Flexible delegation and access control

It also ensures that as your platform grows, your structure remains manageable and predictable.