> For the complete documentation index, see [llms.txt](https://docs.flora.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flora.ai/organizations/organizations.md).

# Organizations

How organizations, workspaces, seats, and shared billing work in FLORA

> **Who this is for:** Organizations are for **Enterprise** customers who run **more than one workspace** under a single account — one bill, one seat pool, one shared usage pool. If you're on a self‑serve plan with a single workspace, nothing changes for you: see [Workspaces](/faqs-how-to.../workspaces.md). Org‑wide settings are managed by an **Admin**.

FLORA has two levels: your **organization** (the commercial account) and your **workspaces** (where work happens).

* **Organization** — billing, plan, seats, and the shared usage pool. It's the account you pay for.
* **Workspace** — projects, canvas, assets, folders, members, and API keys. It's where people actually create.

Every workspace belongs to exactly one organization. An Enterprise organization can hold **several workspaces**.

***

## How they relate

```
Your organization        ← billing, plan, seats, shared usage
  ├── Workspace A         ← projects, canvas, members
  ├── Workspace B
  └── Workspace C
```

Two kinds of membership decide what a person can do:

| Membership                  | Answers                                                                | Carries          |
| --------------------------- | ---------------------------------------------------------------------- | ---------------- |
| **Organization membership** | "Do they belong to the paid account, and what authority do they have?" | Role + a seat    |
| **Workspace membership**    | "Which workspaces can they enter?"                                     | Workspace access |

A person needs **both**: an organization membership to belong to the account, and a workspace membership for each workspace they should be able to open. Every member belongs to **at least one workspace** — there are no organization‑only members. Being an Admin does **not** automatically give access to every workspace — workspace access is always assigned explicitly.

***

## Getting around

There are two surfaces to know — one for **managing** your organization, one for **working** inside a workspace.

### Manage your organization and workspaces

Open **Settings** for everything administrative. It's grouped into two sections:

* **Organization**
  * **Members & Roles** — your people: the member list, roles, seats, and which workspaces each person can access. This is where you administer *who* is in the account.
  * **Analytics** — usage across your organization.
* **Workspaces** — the workspaces in your organization. Use the **+** to create one, or select a workspace to manage its settings.
  * **All** — every workspace in one table, with its usage this period and an editable spend limit. Use it to review and change limits without opening each workspace. See [Per‑workspace spend limits](#per-workspace-spend-limits).

Plan and seats live under **Plans & Billing**; **Members & Roles** also shows your usage, wallet, and overage at a glance.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-4bf1e2a4c5d11eaa949a8450617fddc6340f7312%2Forg-settings-nav.png?alt=media" alt="Settings navigation showing the Organization section (Members &#x26; Roles, Analytics) and the Workspaces list" width="360"><figcaption><p>Settings — manage your organization (Members &#x26; Roles, Analytics) and its workspaces</p></figcaption></figure>

### Switch into a workspace to create

When you want to actually make something, use the **workspace switcher** at the top of the sidebar. It shows your organization and every workspace under it — use **Search Orgs & Workspaces** to filter, then click a workspace to jump in. A checkmark marks your current workspace, and your projects, canvas, and assets all live inside the selected one.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-91a8f1d9ca3620de378ffe80493c53300d146cf0%2Fworkspace-switcher.png?alt=media" alt="Workspace switcher showing the organization with its workspaces nested underneath" width="360"><figcaption><p>The workspace switcher — jump into a workspace to start creating</p></figcaption></figure>

***

## Roles

Roles are set at the **organization** level. A person has **one role** that applies across every workspace they belong to — you can't make someone an Admin in one workspace and a Member in another.

| Role              | What they can do                                                                                       | Uses a seat? |
| ----------------- | ------------------------------------------------------------------------------------------------------ | ------------ |
| **Admin**         | Manage members, roles, workspaces, and billing.                                                        | Yes          |
| **Member**        | Create and edit in the workspaces they're assigned to.                                                 | Yes          |
| **Billing Admin** | Manage billing, seats, members, and workspace settings, without creative editing or generation access. | No           |
| **Guest**         | Limited, view‑and‑comment access in the workspace(s) they're added to.                                 | No           |

* **Admin** authority is account‑wide, but an admin still needs to be assigned to a workspace to open it.
* **Billing Admin** suits finance or operations people who manage the account but don't work on the canvas. It consumes **no seat**.
* **Guest** consumes **no seat**.
* Change a role from the **Role** dropdown on a member's row. It applies across **all** their workspaces.
* An organization always keeps at least one owner. You can't change the last owner's role; make another member an owner first.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-598dc36727579d4484e547983d60b5c38fcd8d9a%2Frole-dropdown.png?alt=media" alt="Role dropdown showing Admin, Member, and Guest" width="360"><figcaption><p>The Role dropdown — Admin, Member, or Guest</p></figcaption></figure>

***

## Renaming your organization

Admins can rename the organization on the **Members & Roles** page. Click the organization name at the top, type the new name, and press **Enter** or click away to save. Other members see the name as plain text.

***

## Members & Roles

**Settings → Organization → Members & Roles** is where Admins manage everyone on the account.

At the top you'll see your organization name, member count, and seat count (for example, *5 seats — Unlimited*), plus three summaries:

* **Usage this period** — included usage used, the reset date, and overage used this period
* **Wallet** — your non‑expiring extra‑usage balance
* **Overage** — on‑demand spend accrued this period

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-cbd4814d7e181a26a21e6415795543a628a28d12%2Fmembers-and-roles.png?alt=media" alt="The Members &#x26; Roles page with organization usage, wallet, overage, and the member table" width="960"><figcaption><p>Members &#x26; Roles — org usage at the top, members below</p></figcaption></figure>

Below the summaries, every member appears in a table:

* **Person** — name and email
* **Role** — Admin, Billing Admin, Member, or Guest (change it from the dropdown)
* **Usage (this month)** — that person's spend across the organization
* **Organization member limit** — a dollar cap on that person's usage across **all** workspaces (see [Organization member limits](#organization-member-limits))
* **Workspaces** — a chip for each workspace they can access; click the **×** on a chip to remove them from that workspace only

Use **Search by name or email** above the table to find a member across the whole organization. Long member lists load more rows as you scroll, or click **Load more**.

The **⋯** menu at the end of a row has **Remove from organization**, which removes the person from the account entirely (and frees their seat).

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-67628a7851d5083a7b129d58926f4b44dec3f9be%2Fmember-remove-from-org.png?alt=media" alt="Row actions menu with Remove from organization" width="320"><figcaption><p>The ⋯ menu — Remove from organization</p></figcaption></figure>

***

## Add a member

Click **Add Member** on the Members & Roles page.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-bfd9093e06f159cadae792547e0cb811328451f0%2Fadd-member-modal.png?alt=media" alt="Add member to organization modal with email, organization role, and workspace checkboxes" width="360"><figcaption><p>Add member to organization</p></figcaption></figure>

Fill in:

1. **Email** — their work email
2. **Organization role** — Admin, Billing Admin, Member, or Guest
3. **Workspaces** — tick at least one

Every member must belong to **at least one workspace** — there are no members without a workspace. Click **Send invite**, and they'll get an email to join your organization and the workspace(s) you selected.

If the email already belongs to someone in your organization, adding them to more workspaces uses **no extra seat** and sends **no new invite** — they're simply assigned.

***

## Create a workspace

Under **Settings → Workspaces**, click the **+**. Enter a **Workspace name** and click **Create**.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-ea26094218926e8d2c28f96cba2d1cef97e93f33%2Fcreate-workspace.png?alt=media" alt="Create workspace modal with a name field and Create button" width="420"><figcaption><p>Create a workspace inside your organization</p></figcaption></figure>

The new workspace:

* Belongs to your organization
* Shares the org's plan, seats, and usage pool
* Does **not** create a separate bill

After creating it, add people by assigning workspaces on **Members & Roles**, or from the workspace's own **Members** page.

***

## Workspace settings

Open a workspace and go to its settings to manage that workspace on its own. Each workspace has:

* **General** — name, identification, icon, and more
* **Access & Permissions** — member access, model availability, and **Allow editors to create API keys** for this workspace (on by default; when off, only admins can create keys)
* **Members** — manage who belongs to this workspace, and set a **Workspace member usage limit** on each person (see [Workspace member usage limits](#workspace-member-usage-limits))
* **Usage** — this workspace's generation usage and export
* **Spend limit** — the maximum this workspace can draw from the shared org pool (see [Per‑workspace spend limits](#per-workspace-spend-limits))
* **API Keys** — API access for this workspace. Keys work with the [FLORA API](/api.md) and with [FLORA MCP](/mcp/authentication.md) for agents that can't sign in through a browser

To stop editors from creating API keys in every workspace at once, an org admin turns on **Only admins can create API keys** under **Settings → Workspaces → All → API key access**. Existing keys keep working. See [Create a key](/api/platform/authentication.md#create-a-key).

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-1c91ee1f13f51509773422c2ffdc993cc22f0cb3%2Fworkspace-settings.png?alt=media" alt="Workspace settings with General, Access &#x26; Permissions, Members, Usage, Spend limit, and API Keys" width="960"><figcaption><p>Per‑workspace settings</p></figcaption></figure>

Removing someone from a workspace here doesn't free their seat if they're still in another workspace — seats are an organization‑level resource. To change someone's **role**, use **Members & Roles**; roles apply org‑wide, not per workspace.

***

## Seats

A **seat** is one person on the paid account with a billable role (Admin or Member). Seats are counted at the **organization** level.

* **One person = one seat**, no matter how many workspaces they're in.
* **Guests don't use a seat.**
* Adding someone who's **already in your org** to another workspace uses **no extra seat** (and sends no new invite).
* **Removing someone from one workspace** while they're still in another **does not** free a seat.
* **Removing someone from their last workspace** deactivates their org membership and **frees the seat**.
* **Removing someone from the organization** (the ⋯ menu on their row) frees the seat and removes all their workspace access.

Your seat count comes from your subscription. Plan and seats are managed under **Plans & Billing**.

***

## Billing and Usage

Your organization has:

* **One bill** — a single billing entity for the whole org. Adding a workspace does **not** create a separate bill.
* **One shared usage pool** — every workspace draws from the same balance.
* **One plan** — all workspaces in the org share the same plan and entitlements.

Generations always happen **inside a workspace**, but the cost is drawn from the **shared org pool**. Spend keeps the originating workspace attached for reporting, so you can still see which workspace used what.

Where to look:

* **Members & Roles** — usage this period, wallet, and overage at a glance.
* **Plans & Billing** — change your plan, manage seats, and open your Stripe billing portal.

### Usage limits at a glance

Admins can cap spend at three levels. All three can apply at once — a generation must fit within every limit that is set.

| Limit                            | Caps                                                     | Where to set it                   |
| -------------------------------- | -------------------------------------------------------- | --------------------------------- |
| **Organization member limit**    | One person, across **every** workspace                   | **Members & Roles**               |
| **Workspace member usage limit** | One person, in **one** workspace only                    | That workspace's **Members** page |
| **Workspace spend limit**        | **Everyone** in one workspace (the workspace as a whole) | That workspace's **Spend limit**  |

**Organization vs workspace member limit:** both cap a person. The org limit counts their usage everywhere in the account; the workspace limit only counts usage inside that workspace.

Example: Jordan has a **$200/month organization member limit** and a **$50/month workspace member usage limit** in Design. In Design they stop at $50. In other workspaces they can keep generating until their org‑wide total hits $200.

When a personal limit is hit, their header usage indicator shows their individual percentage (or "Limit reached").

### Organization member limits

Caps one person's total usage across **all** workspaces. Spend in Workspace A and B both count toward the same cap.

On **Members & Roles**, open **Organization member limit** on their row (it shows **No limit** until set). Enter a dollar amount and choose a reset period — **No reset** or **Monthly**. Use **Clear** to remove it.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-50038b71637ee83ea7a06fb5e1f016a4c828802c%2Forganization-member-limit.png?alt=media" alt="Members &#x26; Roles table showing Role, Usage this month, and Organization member limit columns" width="640"><figcaption><p>Members &#x26; Roles — Organization member limit column</p></figcaption></figure>

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-862401098720136d7e947bc614fb5958ab16334e%2Forganization-member-limit-set.png?alt=media" alt="Set organization member usage limit dialog with dollar amount and No reset or Monthly reset period" width="360"><figcaption><p>Set an organization member usage limit and reset period</p></figcaption></figure>

### Workspace member usage limits

Caps one person's usage in **one** workspace. Other workspaces are unaffected.

Open the workspace's **Members** page. In the **Workspace member usage limit** column, set a dollar amount and period with the same controls as the org limit (**No reset** or **Monthly**). Use **Clear** to remove it.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-19395012594aed63b1bb84e447680abb13af5581%2Fworkspace-member-usage-limit.png?alt=media" alt="Members table with Person, Usage this month, and Workspace member usage limit columns" width="960"><figcaption><p>Workspace Members — set a per‑person usage limit for this workspace</p></figcaption></figure>

### How member limits interact

If both limits use the **same** reset period, the workspace cap cannot be higher than the org cap (and you can't lower the org cap below an existing same‑period workspace cap). Different periods are enforced independently.

### Per‑workspace spend limits

Because every workspace shares the organization's usage pool, you can cap how much any single workspace spends — across everyone in it. Open the workspace's settings and, under **Usage & Limits → Spend limit**, set a dollar limit and choose a reset period — **All time** (no reset unless you change it) or **Per month** (resets every month). Use **Clear** to remove the limit. This keeps one workspace from drawing down the whole pool.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-7d15c051255b99a5e6d16f792bba250e56b916cb%2Fworkspace-spend-limit.png?alt=media" alt="Set a usage limit dialog with a dollar amount and a reset period of All time or Per month" width="360"><figcaption><p>Set a per‑workspace usage limit and reset period</p></figcaption></figure>

For how on‑demand (overage) billing works, see the [pricing guide](/plans-and-billing/pricing.md).

***

## Analytics

**Settings → Organization → Analytics** aggregates usage across all your workspaces.

* **Aggregated across N workspaces** — shows which workspaces are included. Pick a date range (for example, *Last 30 days*) and **Export CSV**.
* **This period** — usage split by model type (Text, Image, Audio, Video) and Technique Runs.
* **Model Breakdown** — share and run count per model type; expand a row to drill into per‑workspace and per‑model detail.
* **Usage Trend** — daily usage across the period.

<figure><img src="https://526296967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWthH0GpcCHwVdtbvahZS%2Fuploads%2Fgit-blob-ab0b04c14e20635212b9b1099d53cf092c215742%2Fanalytics.png?alt=media" alt="Organization Analytics with model breakdown and usage trend aggregated across workspaces" width="640"><figcaption><p>Analytics — model breakdown and usage trend across all workspaces</p></figcaption></figure>

> CSV reports are the reliable source of record. The on‑screen trend and teammate figures are aggregate estimates.

***

## Quick reference

| I want to…                                      | Do this                                                              |
| ----------------------------------------------- | -------------------------------------------------------------------- |
| Rename my organization                          | Click the organization name at the top of **Members & Roles**        |
| Invite someone new                              | **Members & Roles → Add Member** (email + role + workspaces)         |
| Add an existing org member to another workspace | Assign them a workspace — no email, no extra seat                    |
| Find a specific member                          | **Search by name or email** above the member table                   |
| Change someone's role                           | **Role** dropdown on their row (applies org‑wide)                    |
| Cap one person's usage across the whole org     | **Members & Roles** → **Organization member limit**                  |
| Cap one person's usage in one workspace         | That workspace's **Members** page → **Workspace member usage limit** |
| Cap a whole workspace's spend from the org pool | That workspace's settings → **Spend limit**                          |
| Remove from one workspace                       | Click the **×** on that workspace chip                               |
| Remove from the org / free a seat               | **⋯ → Remove from organization**                                     |
| Create a workspace                              | **Settings → Workspaces → +**                                        |
| Review every workspace's spend limit            | **Settings → Workspaces → All**                                      |
| Change plan or seats                            | **Plans & Billing**                                                  |
| See usage                                       | Top of **Members & Roles**                                           |
| Create an API key for a workspace               | That workspace's settings → **API Keys**                             |
| Let only admins create API keys, org-wide       | **Settings → Workspaces → All → API key access**                     |
| Connect an AI agent (Claude, ChatGPT, Cursor…)  | [Install FLORA MCP](/mcp/install.md)                                 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flora.ai/organizations/organizations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
