AI API Keys
Path: Settings → AI API Keys
AI API Keys are the LLM provider keys your agents and task agents run on. Foldspace ships a built-in default key so everything works out of the box, and you can bring your own key from a supported provider.
The keys list
Section titled “The keys list”Each row is a key, with:
| Column | What it shows |
|---|---|
| Name / Description | Your label for the key. |
| Provider | The key’s provider (Foldspace built-in, OpenAI, or Gemini). |
| Usage | The agents and task agents currently using this key. Open it to see the full list. |
| Default | A star marks the default key. |
| Created By / Created Date | Provenance. |
Foldspace includes a built-in Foldspace key (the “Default Foldspace Key”) so new accounts have a working model immediately.
Add a key
Section titled “Add a key”-
Click Create.
-
Fill in the key:
Field Purpose Provider The LLM provider: OpenAI or Gemini. Name A label for the key. Description Optional note. Secret Key The provider’s secret API key. Default When on, any new Agent or Task Agent automatically uses this key. -
Click Test Connection to verify the key reaches the provider, then Create.
The default key
Section titled “The default key”The starred key is the default: new agents and task agents automatically use it. You can change which key is default at any time. To see exactly which agents and task agents a key powers, open its Usage — it lists every Agent and Task Agent (with links) bound to that key.
Related
Section titled “Related”- User Management: the AI API Key feature is one of the permissions you can grant per teammate.
- Cost & tokens: track spend and token consumption per model and provider.