For details on how to authenticate requests using API keys, see Authentication.
Key Lifecycle
| State | Description |
|---|---|
| Active | Key is valid and can authenticate requests |
| Expired | Key has passed its expires_at date and is rejected |
| Revoked | Key was manually deactivated and cannot be used |
Management Endpoints
Create key
Generate a new API key with optional expiration
List keys
View all keys for your organization
Revoke key
Immediately deactivate a key
Common Workflows
Creating a Key for an Integration
Rotating Keys
- Create a new key with Create API Key
- Update your integration to use the new key
- Verify the new key works
- Revoke the old key with Revoke API Key
Auditing Keys
Use List API Keys to review:- Which keys exist for your organization
- When each key was created and last used
- Which keys are approaching expiration