Platform settings: tool keys

The Tool Keys tab in Platform Settings holds the shared pool of provider keys behind web search and web read. The pool serves every company; no client role can open or change it. Use this tab to add keys, label them, and take burned or retired keys out of rotation.

The pool

The table shows one row per key, with Provider, Key, Label, Status and Added:

ColumnShows
ProviderBrave Search, Firecrawl or GitBook Docs.
Key•••• plus the last four characters of the secret. The stored key is never shown.
LabelThe annotation on the batch the key arrived in, when one was given.
StatusEnabled or Disabled.
AddedWhen the key entered the pool.

Rows are ordered by provider, then oldest first. The platform picks among a provider's enabled keys per request, so several keys per provider are normal; one burned key never stops the pool. The table's export action writes every row, named provider-credentials.

Add keys to the pool

  1. Open Platform Settings > Tool Keys.
  2. Click Add keys.
  3. Choose the Provider.
  4. Paste the keys, one per line, into the Keys field (Keys *).
  5. Optionally add a Batch label (optional).
  6. Click Add keys.

Each line becomes its own pool row, and the toast confirms {n} key(s) added to the pool.

Important

Keys are write-once. After a batch is added, the pool never shows or reissues the secret, and the secret itself can never be edited. Rotate by disabling the old key and adding a new one.

Edit a key's label

  1. Open the row menu and choose Edit label (double-clicking the row does the same).
  2. Edit key label opens for the row {Provider} key ••••{secretHint}.
  3. Type the label. A blank value clears it.
  4. Click Save. The toast confirms Key updated.

Labels are annotations only, up to 200 characters; they never affect which requests a key serves.

Disable or enable a key

Disabled keys leave the pool on the next request - the proxy stops load-balancing onto them. Keys are never deleted, so usage history stays attributable.

Rotate a key

Rotation is a two-step move, because a stored secret can never be edited in place:

  1. Disable the burned key and confirm, as above.
  2. Add keys and paste the replacement.

The pool attributes every served request to the exact key row that served it. Replacing a stored secret would make that record wrong, so the pool forbids it.

Keep web tools available

Web tool calls need at least one enabled key. With none available, calls fail with a temporary unavailable error (503) until a key is added or enabled. The pool rebuilds itself after a platform restart, and every pool change rebuilds it at once, so the state clears without manual steps.

Questions, answered

How many keys can I add in one batch?

Up to 100. Each line becomes its own pool row; blank and duplicate lines are dropped.

Can I add keys for several providers in one batch?

No. A batch belongs to one Provider; run Add keys again for another provider.

How do I rotate a burned key?

Disable the old key, then Add keys with the replacement. The secret of an existing key can never be edited.

Can I delete a key?

No. Disable takes a key out of service, and the row is kept so past requests stay attributable to it. Nothing in the pool is ever deleted.

What do the four dots and the hint show?

•••• plus the last four characters of the stored key. That hint is the only part of a stored secret the console shows.

How fast does disabling take effect?

On the next request: the key leaves the pool then, so it stops serving almost immediately.

What happens if the pool has no enabled keys?

Tool calls that need a key are refused with a temporary unavailable error (503) until a key is added or enabled. The pool rebuilds itself after a platform restart.

Why did Add keys refuse my paste?

It found no usable key in the box. Paste at least one key, one per line; the message is Paste at least one key (one per line).

What does "Provider key not found" mean?

The row you acted on could not be found, usually because the list was out of date. Open the tab again and retry.

What is the batch label for?

It annotates the keys that arrived in one batch, for example batch 2026-07, and shows in the Label column. A blank edit clears it; the limit is 200 characters.