What are API keys?
API keys let external tools β like AI assistants β access your Clonra account. Each key is a secure token that authenticates requests on your behalf.
API keys are an alternative to logging in with your email and password. They're designed for automated tools and integrations.
Creating an API key
Go to Profile
Scroll to API Keys
Click Create API Key
Enter a descriptive name (e.g., "Claude Code - Work laptop")
Optionally set an expiration date
Click Create
Your new key appears once. Copy it immediately and store it securely β you won't be able to see it again.
All Clonra API keys start with clnr_ so you can identify them easily.
Best practices
Use descriptive names
Name keys after where they're used: "Claude Code", "Cursor IDE", "Home computer". This helps you know which key to revoke if needed.
Create separate keys for each tool
If you use multiple AI assistants or devices, create a separate key for each. This way you can revoke one without affecting the others.
Set expiration dates
For temporary access or testing, set an expiration date. The key will stop working automatically after that date.
Revoke unused keys
If you stop using a tool or switch computers, revoke the old key. There's no cost to creating new keys.
Viewing your keys
Go to Profile > API Keys to see all your active keys. For security, only the key prefix is shown (e.g., clnr_abc1...), not the full token.
You can also see when each key was last used, helping you identify inactive keys.
Revoking a key
If a key is compromised or no longer needed:
Go to Profile > API Keys
Find the key you want to revoke
Click Revoke
The key stops working immediately. Any tool using that key will get authentication errors until you update it with a new key.
If you lose a key
You can't recover a lost API key. Create a new one and update your tool's configuration with the new key. Then revoke the old key to prevent unauthorized access if someone finds it.
