API Keys

API keys give you programmatic access to your Bigmind data. You'll need an API key to integrate Bigmind with your applications, run automated scripts, or build custom integrations.

#What are API keys?

An API key is a unique identifier that authenticates your application when making requests to the Bigmind API. Think of it like a password—it proves you have permission to access your organization's data programmatically.

#Creating your first API key

Here's how to generate an API key:

1. Navigate to Settings — Click on your avatar in the top right corner and select "Settings"
2. Go to API Keys — In the settings sidebar, find and click on "API Keys"
3. Create a new key — Click the "Create API key" button in the top right
4. Name your key (optional) — Give your key a descriptive name like "Production API" or "Development Key" to help you identify it later
5. Click Create — Your new API key will be generated

#Copying your API key

This is important: When your API key is created, you'll see it displayed one time only. Once you close this dialog, you won't be able to see the full key again.

To save your key:

1. Click the "Copy" button next to your API key
2. Store it somewhere secure (like a password manager or environment variables)
3. Click "I've copied the key" once you've saved it

#Security best practices

Your API keys have full access to your organization's data. Keep them safe:

• Never share API keys publicly — Don't commit them to Git repositories or share them in chat messages
• Use environment variables — Store keys in environment variables, not in your code
• Rotate keys regularly — Delete old keys and create new ones periodically
• Use separate keys per environment — Create different keys for development, staging, and production
• Delete unused keys — If you're no longer using a key, delete it immediately

#Using your API key

Include your API key in the Authorization header of your API requests:

Authorization: Bearer sk_your_api_key_here

For example, using curl:

curl https://api.bigmind.com/v1/meetings \
  -H "Authorization: Bearer sk_your_api_key_here"

#Managing API keys

You can view all your API keys in the Settings > API Keys page. Each key shows:

• Name — The descriptive name you gave it
• Key preview — A masked version of the key (sk_••••••••••••••••••••••••••••••••)
• Created date — When the key was generated
• Last updated — When the key was last modified

#Deleting an API key

If you need to revoke access or remove an unused key:

1. Hover over the API key in the table
2. Click the "Delete" button that appears
3. Confirm the deletion

Warning: Once you delete an API key, any applications using that key will immediately stop working. This action cannot be undone.

#What to do if your key is compromised

If you accidentally exposed your API key or suspect it's been compromised:

1. Delete the compromised key immediately — Go to Settings > API Keys and delete it
2. Create a new key — Generate a replacement key with a new name
3. Update your applications — Replace the old key with the new one in your code
4. Monitor for unusual activity — Check your API usage logs for any suspicious requests

#Need help?

If you're having trouble with API keys or need assistance integrating with the Bigmind API, reach out to our support team or check out our API documentation.