๐Ÿ”Œ REST API

Feedback API: simple, fast, secure

Send feedback programmatically from your backend, CLI tools, or automation scripts. REST API with API key authentication.

๐Ÿ”Bearer token auth ยท Rate limiting ยท CORS support

Send feedback with curl

Useful for scripts, CI/CD pipelines, or command-line tools.

# Verstuur feedback via curl
curl -X POST https://api.fluister.dev/v1/feedback \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "YOUR_PROJECT_ID",
    "text": "De login knop werkt niet op mobiel",
    "page": "/login",
    "userEmail": "user@example.com"
  }'

JavaScript fetch example

Send feedback from your frontend (e.g. after an error or purchase).

// Verstuur feedback via JavaScript fetch
async function submitFeedback(text, page) {
  const response = await fetch('https://api.fluister.dev/v1/feedback', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      projectId: 'YOUR_PROJECT_ID',
      text: text,
      page: page,
      userEmail: 'user@example.com' // optioneel
    })
  });
  
  const data = await response.json();
  console.log('Feedback submitted:', data);
}

// Gebruik:
submitFeedback('Bug in checkout', '/checkout');

API Response

The API immediately returns the feedback with AI categorization and impact score:

// Response (JSON)
{
  "id": "fb_abc123xyz",
  "projectId": "proj_xyz",
  "text": "De login knop werkt niet op mobiel",
  "page": "/login",
  "category": "bug",          // AI-gecategoriseerd
  "sentiment": "negative",     // AI-sentiment
  "impactScore": 8,            // 0-14 prioriteit
  "createdAt": "2026-04-09T10:30:00Z"
}
๐Ÿ’ก Note: Never use your API key in client-side code (publicly accessible). Only for server-side or secure CLI tools.

API use cases

๐Ÿšจ

Error logging

Automatically send feedback on server error or exception. Attach error stack trace to feedback.

๐Ÿ”„

CI/CD integration

Send feedback after a failed test or deployment. Log build issues directly in Fluister.

๐Ÿ“Š

Monitoring alerts

Connect your monitoring tools (Sentry, Datadog) to Fluister. Alert = automatic feedback item.

๐Ÿค–

Chatbots

Let your chatbot (Discord, Slack) forward feedback to Fluister. Centralized inbox.

Frequently asked questions

How do I get an API key?

Log in to your Fluister dashboard, go to Project Settings โ†’ API Keys. Click "Create API Key". Save the key securely โ€” it is only shown once.

Are there rate limits?

Yes. 100 requests per minute per API key. For higher limits contact support@fluister.dev.

Can I use the API without an API key?

No. Authentication is required to prevent abuse. Use Bearer token authentication (see examples).

Does AI triage also work via the API?

Yes. Every feedback via the API is automatically categorized (bug/feature/question) and gets a sentiment score and impact score.

Start with the Fluister API

Create a free account, generate your API key, and send your first feedback in < 5 minutes.

Create free account