Feedback Ingestion API

curl

curl -X POST https://tensient.com/api/feedback/ingest \
  -H "Authorization: Bearer tns_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "bug_report",
    "subject": "Payment fails at checkout",
    "description": "Clicking Pay does nothing after entering card details. No error shown.",
    "submitter": {
      "email": "user@example.com",
      "name": "Alex Smith",
      "externalId": "usr_123",
      "isAuthenticated": true
    },
    "context": {
      "url": "https://mygame.com/checkout",
      "pageTitle": "Checkout",
      "locale": "en-US",
      "timezone": "America/New_York",
      "browser": { "name": "Chrome", "version": "124.0" },
      "os": { "name": "macOS", "version": "14.4" },
      "screen": { "width": 1440, "height": 900, "viewportWidth": 1440, "viewportHeight": 789 },
      "hardware": { "webdriver": false }
    },
    "customContext": {
      "gameSessionId": "sess_abc123",
      "transactionId": "txn_xyz789"
    },
    "tags": ["checkout", "payments"]
  }'

JavaScript / TypeScript

const response = await fetch("https://tensient.com/api/feedback/ingest", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tns_YOUR_KEY_HERE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    category: "bug_report",
    subject: "Payment fails at checkout",
    description: "Clicking Pay does nothing after entering card details.",
    submitter: {
      email: "user@example.com",
      externalId: "usr_123",
      isAuthenticated: true,
    },
    context: {
      url: window.location.href,
      pageTitle: document.title,
      locale: navigator.language,
      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
      userAgent: navigator.userAgent,
      screen: {
        width: screen.width,
        height: screen.height,
        viewportWidth: window.innerWidth,
        viewportHeight: window.innerHeight,
        pixelRatio: window.devicePixelRatio,
      },
      hardware: {
        cpuCores: navigator.hardwareConcurrency,
        deviceMemory: (navigator as any).deviceMemory,
        touchSupport: navigator.maxTouchPoints > 0,
        webdriver: navigator.webdriver,
      },
      network: {
        online: navigator.onLine,
        effectiveType: (navigator as any).connection?.effectiveType,
      },
    },
    customContext: {
      gameSessionId: "sess_abc123",
    },
  }),
});

const result = await response.json();
// result.trackingId  — save this to show the user their ticket link
// result.trackingUrl — e.g. https://tensient.com/feedback/track/fb_a1b2c3

Python

import requests

response = requests.post(
    "https://tensient.com/api/feedback/ingest",
    headers={
        "Authorization": "Bearer tns_YOUR_KEY_HERE",
        "Content-Type": "application/json",
    },
    json={
        "category": "bug_report",
        "subject": "Payment fails at checkout",
        "description": "Clicking Pay does nothing after entering card details.",
        "submitter": {
            "email": "user@example.com",
            "externalId": "usr_123",
            "isAuthenticated": True,
        },
        "context": {
            "url": "https://mygame.com/checkout",
            "pageTitle": "Checkout",
        },
        "customContext": {
            "gameSessionId": "sess_abc123",
            "transactionId": "txn_xyz789",
        },
    },
)

data = response.json()
tracking_id = data["trackingId"]   # e.g. "fb_a1b2c3d4e5f6"
tracking_url = data["trackingUrl"] # share with the user

Success — 201 Created

// HTTP 201
{
  "id": "uuid-of-the-submission",
  "trackingId": "fb_a1b2c3d4e5f6",
  "trackingUrl": "https://tensient.com/feedback/track/fb_a1b2c3d4e5f6",
  "status": "new",
  "createdAt": "2026-03-28T10:00:00.000Z"
}

Store trackingId or show trackingUrl to the submitter so they can follow their ticket status.

Error responses

// 400 — Validation error
{ "error": "category must be one of: bug_report, feature_request, help_request, urgent_issue" }
{ "error": "subject is required." }
{ "error": "description must be 10,000 characters or fewer." }

// 401 — Auth error
{ "error": "Missing API key. Use Authorization: Bearer tns_... or X-API-Key header." }
{ "error": "Invalid or revoked API key." }

// 429 — Rate limit
{ "error": "Rate limit exceeded. Max 60 submissions per minute per API key." }