Quickstart

01 One key, plain HTTPS

Every service is a resource under api.plurism.dev, authenticated with a Bearer key scoped per project. Create a support thread:

curl -X POST https://api.plurism.dev/support/threads \
  -H "Authorization: Bearer $PLURISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Reset password button does nothing on Safari",
    "category": "bug",
    "reporter_email": "user@example.com",
    "reporter_name": "Alice"
  }'

The response includes a ref (like ACME-42) for a human to quote, and a lookup_url carrying a capability token. Send the URL, not the ref: refs are sequential, so the token is what stops one reporter reading another's thread. On that page they can reply and attach files.

02 Or the typed SDK

The TypeScript SDK covers support, waitlist, feedback, flags, content, changelog and files. Server-side only — never ship your key to a browser.

import { createPlurismClient } from "@plurism/sdk";

const plurism = createPlurismClient({
  baseUrl: "https://api.plurism.dev",
  apiKey: process.env.PLURISM_API_KEY!, // server-side only
});

// Support thread (returns a public ref like ACME-42)
const thread = await plurism.support.threads.create({
  body: "Reset password button does nothing on Safari",
  category: "bug",
  reporter_email: "user@example.com",
  reporter_name: "Alice",
});

// Waitlist signup
await plurism.waitlist.add({ email: "early@adopter.dev", referrer: "x" });

// Feedback
await plurism.feedback.submit({ rating: 9, comment: "Love it" });

// Feature flag
const flag = await plurism.flags.evaluate("new-checkout", { user_id: "u_1" });

// Analytics — your own traffic, back out
const { summary } = await plurism.analytics.traffic({ range: "30d" });

03 Same Cloudflare account? Skip the network

Service bindings are account-scoped, so this applies when your Worker runs in the same Cloudflare account as Plurism — self-hosting, or an arrangement we've set up together. It buys zero-egress, single-digit-ms calls. Everyone else uses plain HTTPS above, which is the normal path:

// wrangler.jsonc — only if your Worker is in the SAME Cloudflare account
{ "services": [{ "binding": "PLURISM", "service": "plurism-api" }] }

// then:
const plurism = createPlurismClient({
  binding: env.PLURISM,
  apiKey: env.PLURISM_API_KEY,
});