Skip to main content
Use API Keys when you need credentials for calling Fetch Hive deployments from your own app or service. This page manages workspace API keys, not third-party provider keys for personal model usage.

Overview

The page separates your Default API Key from any additional keys you create for specific environments or services. Additional keys appear in a table where you can search, filter, rotate, revoke, and review last-used activity. Fetch Hive supports environment-specific keys, so you can keep Production, Staging, and Development access separate.

How do I create an API key?

Open Settings in the sidebar, then click API Keys. If the workspace does not have a default key yet, click Create Default Key. If you want an additional key, click Add API Key. Enter a name and choose the environment. Owners and admins can also check Allow this key to auto-approve actions. That lets requests made with the key send tool_approval: "auto_approve". Members see the checkbox and cannot change it. Destructive actions and Deny rules still apply. See Approvals for agent actions. Choose an environment:
  • Production
  • Staging
  • Development
Save the key. Fetch Hive then shows Your New API Key. Copy the full key right away. The full value is only shown when the key is first created or rotated.

How do I rotate or revoke a key?

Find the key you want to change in Default API Key or the table of additional keys. Use Rotate Key when you want to replace the current secret with a new one. Use Revoke when you want to disable a key and prevent future use. Fetch Hive asks you to confirm either action before it proceeds.

Why can I only copy part of a key?

After the creation or rotation dialog closes, the page keeps the masked key prefix for reference but usually no longer has the full key value available to copy. That is why you should copy the full secret from Your New API Key before you close that dialog. The masked display is still useful for confirming which key you are looking at and checking its environment, status, and last-used information.

How do I limit what a key can spend?

You can set a monthly spending limit on any API key. Open Edit on the key, then use Monthly spending limit.
  • Warn at (USD): when the key’s spend this month passes this amount, Fetch Hive emails the account owner once.
  • Block at (USD): when the key’s spend this month reaches this amount, new requests made with that key are rejected with a spend_cap_exceeded error. Other keys in the workspace keep working.
Limits count hosted AI spend for the calendar month (UTC) and reset on the first day of each month. A request that is already running when the limit is reached is completed and billed; the next request is blocked. You can also set a limit for the whole workspace under Workspace Settings. The Monthly limit column on the API Keys page shows spend so far against each key’s limit. Only account owners and admins can change limits. See Error codes for the spend_cap_exceeded response.

How is this different from provider credentials?

Workspace API keys authenticate requests to Fetch Hive deployments. They are different from provider credentials you connect for Personal charge type. For that flow, use Use your own API Key and Integrations.