# Settings and your API key

> Flowmaps's AI features run on Claude, using your own Anthropic API key. You stay in control of the costs and the account, and Flowmaps never pays for or se

Canonical: https://flowmaps.app/docs/settings-and-api-key

Account

# Settings and your API key

Last updated: October 2026

Flowmaps's AI features run on **Claude**, using **your own Anthropic API key**. You stay in control of the costs and the account, and Flowmaps never pays for or sees your usage.

Just starting? The first 100 accounts get [25 free AI actions](#free-ai-actions), so you can try the AI before you add a key.

There's **one key per workspace**. The workspace owner adds it, and everyone in the workspace uses it. Invited to someone else's workspace? Then you don't need a key of your own there: Settings shows _"Provided by …"_. See [Teams](https://flowmaps.app/docs/teams).

## Is this a Claude subscription?

No. An API key is separate from Claude Pro or Max, and you don't need either of them for Flowmaps.

- You make a free account at [console.anthropic.com](https://console.anthropic.com) and add a little credit under **Billing**.
- You pay Anthropic only for what you use. Most AI actions in Flowmaps cost a few cents; a big scan or a set of build prompts can cost a few tens of cents.
- A few dollars of credit is enough to plan several apps.

Building is something else: Claude Code, Cursor or Lovable build your features on their own plan, not on this key.

## Free AI actions

The first 100 Flowmaps accounts get **25 free AI actions**, on us. You don't need a key for them.

- **One action is one click** on an AI button: _Recommend features_, _Generate_ build prompts, _Suggest follow-ups_ on a card, _Scan for gaps_, or drafting a help article.
- **The sidebar shows how many you have left**, and so does **Settings → Anthropic API key**.
- **On free actions, a new card doesn't get AI suggestions by itself.** Click _Suggest follow-ups_ on the card when you want them, so you choose where your actions go.
- **If something goes wrong** (Claude is busy, the answer gets cut off), you get the action back.
- **The actions are yours, not the workspace's.** Making another workspace doesn't give you more.
- **To keep them fair**, accounts with a disposable email address don't get them, and only a few new accounts a day can start using them from the same network (like one office or home internet connection). See something like _"limited to a few new accounts per network"_? Try again the next day, or add your own key.
- **When they run out**, nothing is lost: your map, cards and build prompts stay. Add your own key below to keep using the AI.
- **Once you add your own key**, Flowmaps always uses your key, and your free actions stay unused.

While you use free actions, your request goes to Claude through Flowmaps' own Anthropic account instead of yours. Anthropic doesn't use API requests to train its models.

## Which features need a key?

| Feature                                                    | Without a key                      | With a key                      |
| ---------------------------------------------------------- | ---------------------------------- | ------------------------------- |
| Ventures, Mind map, Kanban                                 | ✅ Works                            | ✅ Works                         |
| [AI suggestions](https://flowmaps.app/docs/ai-suggestions) | ✅ With free AI actions, else ❌ Off | ✅ On                            |
| [Build prompts](https://flowmaps.app/docs/build-prompts)   | ✅ With free AI actions, else ❌ Off | ✅ On                            |
| [Flags](https://flowmaps.app/docs/flags)                   | ✅ Standard text                    | ✅ Explanation written by Claude |

## Add your key

1. Go to [console.anthropic.com](https://console.anthropic.com/settings/keys), add a little credit under **Billing** if your account is new, and create an API key. Name it something like `flowmaps` so you can recognise it later.
2. In Flowmaps, open **Settings** in the sidebar.
3. Paste the key (it starts with `sk-ant-`) and click **Save key**.

Flowmaps checks the key with Anthropic, then shows _"Saved to this workspace, encrypted"_ with the start and end of your key.

Anthropic API key

Saved to your account, encrypted: sk-ant-api…7f3cReplace · Remove

## Where your key is kept

- Your key is saved **to the workspace, encrypted**. It works on every device, for everyone in the workspace.
- Flowmaps checks the key with Anthropic when you save it, so you know right away that it works.
- After saving, you only see its start and end (like `sk-ant-api…abcd`), never the full key. Teammates never see it at all, only that a key is there.
- It's only used for AI requests in this workspace, and never logged. Viewers can't use AI features, so they can't spend it.
- **Replace** swaps in a new key; **Remove** deletes it, which turns AI features off for the whole workspace.

## Costs

AI usage is billed by Anthropic to **the key owner's** account, including what teammates use. To stay in control:

- set a **monthly spend limit** in the Anthropic console, and
- give your key an **expiry date**, for example 30 days. When it expires, Flowmaps tells you it was rejected; create a new key and paste it in Settings.

Build prompts use the most text, so they cost a bit more than suggestions and flags.

### Your key versus your Claude plan

Your key pays for **planning** in Flowmaps: recommended features, Scan for gaps, suggestions, build prompts and flag text. Most actions cost a few cents; a big scan or a set of build prompts up to a few tens of cents.

The **building** happens in Claude Code, Cursor or Lovable, on that tool's own plan, not on this key. How much you can build in a day depends on that plan: on **Claude Pro** you reach the limit after a few features, **Max** gives you a lot more. At the limit, Claude tells you when you can carry on.

On a smaller plan:

- keep cards small: one feature, one clear job
- build one card at a time; [building several at once](https://flowmaps.app/docs/build-several) uses your limit faster
- start a new Claude Code chat for each card, so it doesn't re-read everything

Flowmaps shows this once when you save a key, and under **What does the key pay for, and how much can I build?** in Settings.

## When your key stops working

Every AI action runs on the workspace's key. If Anthropic stops accepting it, Flowmaps tells everyone in the workspace instead of failing quietly:

- **Rejected key** (deleted, disabled or mistyped) or **out of credit**: a note appears at the top of every page. Your map, board, the terminal and Claude keep working; only AI actions pause. The owner sees **Update key** or **Add credit**; teammates are asked to tell the owner. The note goes away by itself, for everyone, as soon as the key works again.
- **Rate-limited**: Anthropic limits how many requests a key can make per minute. The action that hit the limit says so; wait a minute and try again. No note at the top, because it passes by itself.
- **Anthropic is down**: the action says Anthropic isn't answering. That's on their side, and your key is fine.

In **Settings → Anthropic API key** you see how the key is doing (_Working_, _Rejected by Anthropic_, _Out of credit_), when it was last checked, and a **Test key** button. Saving a new key tests it straight away with one tiny request (a fraction of a cent).

## Your profile

Under **Settings → Profile**:

- **Your name:** shown in the app, and to your team once you invite people.
- **Photo:** click **Upload photo** (PNG, JPG, WebP or GIF, up to 2 MB). Square photos look best.
- **Email address:** type a new address and click **Change email**. We send a confirmation link; your email only changes once you click it.

Click your name at the bottom of the sidebar to get here quickly.

## Preferences

- **Coding tool:** the tool your build prompts are written for (Claude Code, Codex, Cursor or any agent). You can still pick another one on a card.
- **Appearance:** _match my computer_, _light_ or _dark_. The same switch sits at the bottom of the sidebar.

## Email

**Getting-started emails:** in your first two weeks, Flowmaps sends a few tips: how to map your first idea, connect Claude Code or the terminal, and build your first feature. A tip is skipped when you've already done it, and they stop after two weeks. Switch them off here, or click **Unsubscribe** at the bottom of any tip. Sign-in links and team invites always come.

## Email ideas

Your own address for emailing ideas into this workspace, where they land, and the last emails it received. See [Email ideas to Flowmaps](https://flowmaps.app/docs/email-ideas).

## Plan

Your plan and billing. See [Plans and billing](https://flowmaps.app/docs/plans-and-billing). AI usage on your own key is billed by Anthropic, not by Flowmaps.

## Security

**Sign out on all devices** signs you out everywhere at once, for example after losing a laptop. The `flowmaps` command and Claude stay connected; disconnect those under **Terminal** in Settings.

## Your data

- **Download my data** gives you one file with all your ventures, cards, flags, build prompts, help articles, skills and settings. Your API key and access tokens are not included.
- **Delete my account** removes your account and the workspaces you own, with everything in them (also for the people you invited), and takes your public help pages offline. You're removed from workspaces you were invited to; those keep working. Type `DELETE` to confirm. This can't be undone, so download your data first if you want to keep it.

## Troubleshooting

| Message                                         | What to do                                                                |
| ----------------------------------------------- | ------------------------------------------------------------------------- |
| _"Anthropic rejected your API key"_             | The key expired or was deleted. Create a new one and save it in Settings. |
| _"Anthropic rate limit hit"_                    | Wait a moment and try again.                                              |
| _"This workspace has no Anthropic API key yet"_ | The workspace owner adds one in Settings.                                 |
| _"You can only view this workspace"_            | You're a Viewer. Ask the owner to make you an Editor.                     |

[← PreviousPlans and billing](https://flowmaps.app/docs/plans-and-billing)

Try it on your own app idea

Flowmaps is free to start, and new accounts get 7 days of Pro. No credit card.

[Start free](https://flowmaps.app/login?new=1)
