Managing API Keys
Create, rotate, and revoke API keys for programmatic access to ArtistGuard.
API keys give scripts and integrations access to ArtistGuard without a browser login. Go to Dashboard > API Keys.
API access requires a Pro or Business plan.
Accept the API terms first
First visit? You'll see a banner asking you to accept the API Terms of Use. One-time per organization. Click Review & Accept.
Creating a key
Click New Key. Give it a name that means something, like "GitHub Actions" or "Analytics script". Vague names are useless when something breaks at 2 AM.
After clicking Create, the full key is shown exactly once. Copy it to a password manager right now. After you close the dialog, only the prefix is visible and we cannot recover the original.
Using a key
curl https://v2-prod-api.artistguard.app/api/v1/artists \
-H "Authorization: Bearer ag_live_your_key_here"
No token exchange, no OAuth. The key is the credential.
Key limits by plan
| Plan | Max keys |
|---|---|
| Free | 0 |
| Artist | 0 |
| Pro | 5 |
| Business | 20 |
Revoking a key
Click the trash icon on any key row and confirm. The key stops working immediately. No grace period, no undo.
Suspect a leak? Revoke first, ask questions later.
Rotating a key
- Create a new key
- Update your integration to use it
- Verify it works
- Revoke the old key
Both keys can be active at the same time during the transition.