Authentication
How to authenticate with the Desktop Insights API using Bearer tokens and API keys.
All API requests require authentication via a Bearer token in the Authorization header.
API keys
During early access, API keys are issued directly. Self-serve key generation from the dashboard is coming soon.
Authorization: Bearer di_live_xxxxxxxxxxxxxxxxxxxxxxxx
API keys are prefixed with di_live_ for production use.
Making authenticated requests
Include your API key in every request:
curl "https://desktopinsights.com/api/v1/lookup?app=Slack" \ -H "Authorization: Bearer di_live_your_key_here"
Error responses
| Status | Meaning |
|---|---|
401 Unauthorized | Missing or invalid API key |
400 Bad Request | Missing required parameter |
404 Not Found | No app found matching your query |
Security best practices
- Store API keys in environment variables, not in source code
- Rotate keys if compromised — contact us for a replacement
- Use HTTPS for all requests (HTTP is not supported)