Accounts
View and manage customer accounts — list, detail, rename, audit feed, and quota summary.
An account is your billing organisation and top-level tenant boundary. Every workspace belongs to exactly one account.
Who can access
| Action | Required permission |
|---|---|
| View account list | read on the account |
| View account detail | read on the account |
| Rename account | administer on the account |
| Create account (self-serve) | Only when ALLOW_CUSTOMER_ACCOUNT_CREATE=true in production |
In most production setups, Groundfloor operators provision accounts via the admin API. Account owners then manage workspaces and members.
Prerequisites
- Signed in to app.groundfloor.cloud
- Membership in at least one account
View your accounts
Open Accounts
In the sidebar under Overview, click Accounts.
Browse the list
The table shows Name, Archetype (ISV, Enterprise, or SI agency), Plan, Status, and Created date for each account you can access.
Open an account
Click an account name to open its detail page.
Account detail page
The detail page shows:
- Overview — archetype, plan tier, status, billing contact
- Rename — click the edit control next to the account name (requires
administer) - Workspaces — all workspaces in this account, with links to each
- Quota — usage vs plan limits (see Quotas)
- Billing — plan tier and billing summary card
- Recent activity — last 25 audit events for this account
Create an account
If self-serve creation is enabled, click Create account on the Accounts list page. Enter a name and archetype.
If you don't see a create button, ask your Groundfloor operator to provision an account and assign you as owner.
Export activity
From the account detail page, scroll to Recent activity. For a full export, use the Activity Log page with scope set to Account.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Empty account list | No memberships yet | Ask an operator to provision an account or invite you |
| Cannot rename account | Missing administer | Ask an account owner or admin |
| Create button missing | Self-serve gated | Contact Groundfloor support or your operator |
Related API
GET /v1/accounts— list accountsGET /v1/accounts/{account_id}— account detailGET /v1/accounts/{account_id}/audit— account audit feedGET /v1/accounts/{account_id}/quota— quota usage
See API introduction for authentication.