Skip to content

LLM Provider Key (BYOK)

Your BotBoss agents think and reply using a large language model. Every workspace starts on a free trial that runs on BotBoss's own keys — no card and nothing to set up. When you want to keep going, you can bring your own key (BYOK) from your own Anthropic account, or add a payment method and let BotBoss bill you for what you use. This guide covers both, and where to find each control.

Everything below lives on the LLM page under Workspace. Changing the key, the provider mode, or the spend cap needs the billing permission; anyone who can open the page can see the usage meters.

What you get for free

  • A free-trial allowance per workspace. Your agents run on BotBoss's keys until you have used it. The allowance belongs to the workspace, not to a person, so inviting teammates does not multiply or reset it.
  • A meter that always agrees with the count. The Free trial card shows messages used out of your allowance, and a Monthly free messages card shows this month's usage on BotBoss's pooled key.
  • Early warning. When you are down to the last few messages the meter turns amber and shows how many are left, and the page offers the two ways to carry on. When the allowance is used up it says Trial exhausted and offers the same two options — nothing is wrong, you just need a key or a card.

Option 1: bring your own key

Usage on your own key is billed directly to your provider account. Larger teams often prefer this: your own contract, rate limits, and spend controls. You do two things — create a key at your provider, then paste it into BotBoss.

Create an Anthropic key

  1. Go to console.anthropic.com/settings/keys and sign in (or create an Anthropic account).
  2. Create a key, give it a name such as "BotBoss", and copy it. It starts with sk-ant-.

Anthropic shows the full key only once. If you lose it, create another and delete the old one.

BotBoss supports Anthropic (Claude) keys today. OpenAI is listed in the provider menu as OpenAI (coming soon) and cannot be selected yet.

Paste it into BotBoss

  1. Open Workspace → LLM and find the Your API key card.
  2. Leave Provider on Anthropic (Claude), paste the key into API key, and click Save key.
  3. BotBoss tests the key straight away and shows the result — Working, Key rejected, or Limit reached (a valid key that has hit its spend cap at your provider). To check a key before saving it, click Test without saving instead.
  4. In the Provider mode card, choose Bring your own key. Saving a key stores it; this switch is what makes your agents use it. The card marks the active choice Current.

The field is write-only: BotBoss shows Key on file with a masked value and never displays the key back. To change it, paste a new one and click Replace key. To stop using it, click Remove key — your agents fall back to the BotBoss platform key, and BYOK mode switches back to BotBoss platform if it was on.

If you use a Claude Code subscription, the same card has Connect Claude Code: paste a Claude Code token (it starts with sk-ant-oat) to run your agents on that subscription instead.

Option 2: add a payment method

Prefer to keep using BotBoss's keys? Open Workspace → Billing and add a payment method. You are then billed for metered usage — the tokens your agents actually use. Your free trial converts to paid: same keys, same agents, no interruption, and no key to manage.

Bring your own key or add a card — it is your call. With a key you are billed by your provider and you manage the key; with a card BotBoss bills you and there is nothing to manage. Either keeps your agents running.

Choosing a model

The Model card sets which model every agent in the workspace uses. Free-trial and bring-your-own-key agents choose from the same BotBoss-supported list, so you never need to know a provider's model IDs. The Monthly budget cap card lets you set a monthly spend limit, and the Usage card shows what your agents have used.

Troubleshooting

What you see What it means What to do
Key rejected The key is wrong, revoked, or mistyped. Create a new key at your provider and paste it in with Replace key.
Limit reached on a key test The key is valid, but your provider account has hit its spend cap. Raise the limit in your provider's console — there is no need to rotate the key.
A rate-limit message You have reached your provider's rate limit, not a BotBoss limit. Wait a moment and retry, or raise the limits on your provider plan.
Trial exhausted The free trial is used up. This is not a broken key. On Workspace → LLM, add your own key (Option 1) or a payment method (Option 2).
Save key is greyed out The API key field is empty. Paste a key first. Without the billing permission the key controls are hidden — ask an admin.
An error when choosing Bring your own key BYOK mode needs a key on file. Save a key first, then switch the mode.

A broken key says to fix your key; a used-up trial says you are out of free usage and shows how to continue. They are deliberately different messages, so you always know which one you are looking at.

Is my key safe?

Yes. Your key is encrypted the moment you save it, is never shown back to you or written to logs, and is sent only to your provider to run your agents. The page only ever shows that a key is on file — never the key itself — and every access to the stored key is audited.

Quick reference

You want to Go to
See free-trial usage Workspace → LLM (the Free trial card)
Create an Anthropic key console.anthropic.com/settings/keys
Add your key to BotBoss Workspace → LLM → Your API key → Save key, then Provider mode → Bring your own key
Add a payment method Workspace → Billing
Fix a rejected key Workspace → LLM → paste a new key → Replace key