API Reference
Authentication
How to authenticate with the Lumifeed API.
Authentication
Widget API key
For submitting feedback from the browser, use your project API key as a header or query parameter:
POST https://api.lumifeed.app/v1/feedback
x-api-key: pk_live_abc123Widget keys are write-only — they can submit feedback but not read it. They're safe to include in client-side code.
Bearer token (server-side)
For reading feedback or managing your account server-side, use a Bearer token (available on Pro and Agency plans):
GET https://api.lumifeed.app/v1/projects/{projectId}/feedback
Authorization: Bearer sk_live_abc123Dashboard session
The Lumifeed dashboard uses OAuth session cookies automatically. If you're building integrations that run in the browser while logged in, you don't need to manage tokens.
Headers
| Header | Value |
|---|---|
x-api-key | Your project API key (widget submissions) |
Authorization | Bearer {token} (server-side reads) |
Content-Type | application/json |
Errors
| Status | Meaning |
|---|---|
401 | Missing or invalid API key |
403 | Valid key but insufficient permissions |
429 | Rate limit exceeded |