Skip to main content

​
API Keys

API keys authenticate sync plugins and API requests to your OpenSync instance.

​
Generating Keys

1

Sign in

Sign in to your OpenSync dashboard
2

Open Settings

Click your profile icon and select Settings
3

Generate Key

Click Generate API Key
4

Save securely

Copy the key immediately. It won’t be shown again.

​
Key Format

API keys follow the format:
Example: osk_7a8b9c0d1e2f3g4h5i6j7k8l9m0n

​
Using Keys

​
In Plugins

When running plugin-name login:

​
In API Requests

Include in the Authorization header:

​
Key Storage

Keys are hashed before storage:
We cannot recover your API key if you lose it. Generate a new one if needed.

​
Managing Keys

​
View Keys

In Settings, see a list of your API keys with:
  • Key prefix (first 8 characters)
  • Creation date
  • Last used date

​
Revoke Keys

To revoke a key:
  1. Find the key in Settings
  2. Click Revoke
  3. Confirm revocation
Revoked keys immediately stop working.

​
Security Best Practices

  • Generate separate keys for development and production - Rotate keys periodically - Never commit keys to version control - Use environment variables to store keys - Revoke keys that may be compromised

​
Key Limits