API keys are used to authenticate applications and scripts when they interact with Mistral AI services.
Keys created in a Workspace are scoped to that Workspace. They only grant access to its resources, and their usage is tracked separately in usage reports.
Create a Workspace-scoped API key
1. Open the API keys page
🔑 Make sure the right Workspace is selected as your active context before creating a key.
In the left-hand menu of that Workspace, click API Keys under the Workspace section.
Click API Keys in the left menu
2. Start creating a key
On the Your API keys page, click Create new key.
Click the Create new key button
3. Configure key details
A modal opens with options:
Name (optional): Add a label to help identify the key later (e.g., “Pipeline integration” or “Project X”).
Expiration (optional): Set an expiry date. After this date, the key will stop working.
🔑 We recommend setting an expiration date and regularly rotating API keys (create a new key and delete the old one).
When ready, click Create new key.
Configure the API key with optional name and expiration date
4. Copy and store the key
A confirmation modal will display the key once, in full.
🚨 This is the only time the full key will be shown. Copy it immediately and store it securely (e.g., password manager, secrets vault). It cannot be retrieved again after closing the modal.
Click Done when finished. The key will now appear in the list, with only part of it visible for reference.
Delete an API key
If a key is compromised or no longer needed:
Open the
API Keyspage for the Workspace.Find the key.
Click the trash icon twice to confirm deletion.
Click the trash icon to delete an API key
Notes
📌 You can also create API keys from the Admin Platform interface. Even there, keys must be scoped to a Workspace — Organization-level keys are not supported.