Express API

npm install writeback-sdk

import express from 'express';
import { feedbackRouter } from 'writeback-sdk/express';

const app = express();

app.use(express.json());

// Mount the feedback router
app.use(feedbackRouter({ ingestKey: 'wk_your_ingest_key' }));

app.listen(3000);

curl -X POST https://your-api.com/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "outcome": "confusing",
    "tool_name": "POST /v1/analyze",
    "details": "The docs say the content param accepts markdown but do not specify a max length. Sent 12k tokens and got a 400 with no error message."
  }'

{ "ok": true, "id": "abc123" }

feedbackRouter({
  ingestKey: 'wk_your_ingest_key', // required
  path: '/feedback',                // optional — default is /feedback
  source: 'my-api',                 // optional — identifies your service in reports
})

paths:
  /feedback:
    post:
      summary: Report feedback about this API
      description: >
        Use this endpoint to report what happened after using any part of this API.
        Submit after errors, confusion, or successful completions.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required: [outcome, details]
              properties:
                outcome:
                  type: string
                  enum: [success, failure, confusing, gave_up, request]
                details:
                  type: string
                tool_name:
                  type: string

feedbackRouter({
  ingestKey: process.env.WRITEBACK_INGEST_KEY!,
})