FastComments JavaScript/TypeScript SDK

This is the official JavaScript/TypeScript SDK for FastComments.

Manage comments, users, SSO, and moderation from Node.js or the browser.

Repository

Installation

npm install fastcomments-sdk

API Documentation

Full API reference: docs/api/README.md

Browser vs Server Compatibility

This SDK uses dual entry points to ensure optimal compatibility and prevent runtime errors:

fastcomments-sdk/browser - Browser-safe version with native fetch
fastcomments-sdk/server - Full Node.js version with SSO support
fastcomments-sdk (default) - Types only, safe to import anywhere

Usage

This SDK provides separate entry points for browser and server environments to ensure optimal compatibility and security:

Browser Usage (Client-Side)

For browser/frontend applications, use the browser-safe export that excludes Node.js dependencies:

// Browser-safe import (no Node.js dependencies)
import { createFastCommentsBrowserSDK } from 'fastcomments-sdk/browser';

// Create browser SDK instance
const sdk = createFastCommentsBrowserSDK({
  basePath: 'https://fastcomments.com' // optional, defaults to https://fastcomments.com
});

// Use public APIs (no API key needed - safe for browsers)
const comments = await sdk.publicApi.getCommentsPublic({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Server Usage (Node.js)

For server/backend applications, use the full SDK with SSO and authentication features:

// Server-side import (includes SSO and designed to work with NodeJS)
import { createFastCommentsSDK } from 'fastcomments-sdk/server';

// Create server SDK instance
const sdk = createFastCommentsSDK({
  apiKey: 'your-api-key', // Keep this secret on the server!
  basePath: 'https://fastcomments.com' // optional, defaults to https://fastcomments.com
});

// Use secured APIs with your API key
const comments = await sdk.defaultApi.getComments({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Types Only Import

If you only need TypeScript types (no runtime code), use the default import:

// Types only (no runtime dependencies - safe everywhere)
import type { 
  PublicComment, 
  CreateCommentParams, 
  GetCommentsPublic200Response 
} from 'fastcomments-sdk';

Using Individual API Classes

Browser Environment

import { PublicApi, Configuration } from 'fastcomments-sdk/browser';

const config = new Configuration({
  basePath: 'https://fastcomments.com'
});

const publicApi = new PublicApi(config);

Server Environment

import { DefaultApi, PublicApi, Configuration } from 'fastcomments-sdk/server';

const config = new Configuration({
  apiKey: 'your-api-key',
  basePath: 'https://fastcomments.com'
});

const defaultApi = new DefaultApi(config);
const publicApi = new PublicApi(config);

Public vs Secured APIs

The SDK provides three main API classes:

DefaultApi - Secured endpoints that require your API key for authentication. Use these for server-side operations.
PublicApi - Public endpoints that can be accessed without an API key. These can be called directly from browsers/mobile devices/etc.
HiddenApi - Internal/admin endpoints for advanced use cases.

Example: Using Public API (browser-safe)

import { PublicApi } from 'fastcomments-sdk/browser';

const publicApi = new PublicApi();

// Get comments for a page (no API key required)
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Example: Using Default API (server-side only)

import { DefaultApi, Configuration } from 'fastcomments-sdk/server';

const config = new Configuration({
  apiKey: 'your-api-key' // Keep this secret!
});
const defaultApi = new DefaultApi(config);

// Get comments with full admin access
const response = await defaultApi.getComments({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

SSO (Single Sign-On) Integration

FastComments supports SSO to integrate with your existing user authentication system. SSO functionality is only available in the server export since it requires Node.js crypto features.

Simple SSO (Server-Side Only)

Simple SSO should be generated server-side and sent to the client:

// Server-side code (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Create simple SSO using the built-in helper  
const userData = {
  username: 'john_doe',
  email: 'john@example.com',
  displayName: 'John Doe',
  avatar: 'https://example.com/avatar.jpg'
};

const sso = FastCommentsSSO.createSimple(userData, {
  loginURL: '/login',
  logoutURL: '/logout'
});

const ssoToken = sso.createToken();

// Send ssoToken to your client-side code
// Client-side code can then use this token with the browser SDK

Secure SSO (Server-Side, Recommended)

Secure SSO should be implemented server-side and provides better security:

// Server-side code (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Create secure SSO using the built-in helper
const userData = {
  id: 'user-123',
  email: 'john@example.com',
  username: 'john_doe',
  displayName: 'John Doe',
  avatar: 'https://example.com/avatar.jpg',
  isAdmin: false,
  isModerator: false
};

const sso = FastCommentsSSO.createSecure('your-api-key', userData, {
  loginURL: '/login',
  logoutURL: '/logout'
});

const ssoConfig = sso.prepareToSend();

// Use with API calls on the server
const publicApi = new PublicApi();
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  sso: JSON.stringify(ssoConfig)
});

// Or send ssoConfig to client for browser usage

Using SSO from Browser (with Server-Generated Token)

// Client-side code (browser)
import { PublicApi } from 'fastcomments-sdk/browser';

// Get SSO token from your server endpoint
const ssoToken = await fetch('/api/sso-token').then(r => r.json());

const publicApi = new PublicApi();
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  sso: ssoToken // Use the server-generated SSO token
});

SSO with Comment Creation

// Server-side: Create SSO and comment
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

const sso = FastCommentsSSO.createSecure('your-api-key', userData);
const ssoConfig = sso.prepareToSend();

const response = await publicApi.createCommentPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  broadcastId: 'unique-broadcast-id',
  commentData: {
    comment: 'This is my comment',
    date: Date.now(),
    commenterName: 'John Doe',
    url: 'https://example.com/page',
    urlId: 'page-url-id'
  },
  sso: JSON.stringify(ssoConfig)
});

Common Use Cases

Getting Comments for a Page

const comments = await sdk.publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'article-123'
});

Creating a Comment

const newComment = await sdk.publicApi.createCommentPublic({
  createCommentParams: {
    tenantId: 'your-tenant-id',
    urlId: 'article-123',
    comment: 'Great article!',
    commenterName: 'John Doe',
    commenterEmail: 'john@example.com'
  }
});

Voting on a Comment

const voteResponse = await sdk.publicApi.voteComment({
  voteBodyParams: {
    commentId: 'comment-id',
    direction: 1 // 1 for upvote, -1 for downvote
  }
});

User Management (Requires API Key)

// Search for users (requires DefaultApi)
const users = await sdk.defaultApi.searchUsers({
  tenantId: 'your-tenant-id',
  urlId: 'page-id',
  usernameStartsWith: 'john'
});

Live Events (Real-time Updates)

Subscribe to live events to get real-time updates for comments, votes, and other activities.

Page-Level Events

Listen for live events on a specific page (comments, votes, etc.):

import { subscribeToChanges, LiveEvent, LiveEventType } from 'fastcomments-sdk/browser';

const config = {
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
};

// Subscribe to live events for a page
const subscription = subscribeToChanges(
  config,
  'your-tenant-id', // tenantIdWS
  'page-url-id',    // urlIdWS  
  'user-session-id', // userIdWS (get this from getComments response)
  (event: LiveEvent) => {
    console.log('Live event received:', event);

    switch (event.type) {
      case LiveEventType.new_comment:
        console.log('New comment:', event.comment);
        // Update your UI with the new comment
        break;
      case LiveEventType.new_vote:
        console.log('New vote:', event.vote);
        // Update vote counts in your UI
        break;
      case LiveEventType.updated_comment:
        console.log('Comment updated:', event.comment);
        break;
      default:
        console.log('Other event type:', event.type);
    }

    return true; // Return true if event was handled
  },
  (isConnected: boolean) => {
    console.log('Connection status:', isConnected ? 'Connected' : 'Disconnected');
  }
);

// Close the subscription when done
subscription.close();

Listen for user-specific events (notifications, mentions, etc.):

import { subscribeToUserFeed, LiveEvent, LiveEventType } from 'fastcomments-sdk/browser';

const userConfig = {
  userIdWS: 'user-session-id', // Get this from getComments response
};

// Subscribe to user's personal feed
const userSubscription = subscribeToUserFeed(
  userConfig,
  (event: LiveEvent) => {
    console.log('User event received:', event);

    switch (event.type) {
      case LiveEventType.notification:
        console.log('New notification:', event.notification);
        // Show notification in your UI
        break;
      case LiveEventType.notification_update:
        console.log('Notification updated:', event.notification);
        break;
      default:
        console.log('Other user event:', event.type);
    }

    return true;
  },
  (isConnected: boolean) => {
    console.log('User feed connection:', isConnected ? 'Connected' : 'Disconnected');
  }
);

// Close when done
userSubscription.close();

Getting userIdWS

The userIdWS parameter is required for live events and can be obtained from API responses:

const response = await sdk.publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-id'
});

// Extract userIdWS from the response
const userIdWS = response.data?.userSessionInfo?.userIdWS;

if (userIdWS) {
  // Now you can subscribe to live events
  const subscription = subscribeToChanges(config, tenantIdWS, urlIdWS, userIdWS, handleEvent);
}

Broadcast IDs

You'll see you're supposed to pass a broadcastId in some API calls. When you receive events, you'll get this ID back, so you know to ignore the event if you plan to optimistically apply changes on the client (which you'll probably want to do since it offers the best experience). Pass a UUID here. The ID should be unique enough to not occur twice in a browser session.

import { v4 as uuidv4 } from 'uuid';

const response = await sdk.publicApi.createCommentPublic({
  createCommentParams: {
    tenantId: 'your-tenant-id',
    urlId: 'page-id',
    comment: 'My comment',
    broadcastId: uuidv4() // Unique ID for this operation
  }
});

Error Handling

try {
  const comments = await sdk.publicApi.getCommentsPublic({
    tenantId: 'your-tenant-id',
    urlId: 'page-id'
  });
} catch (error) {
  if (error.response?.status === 404) {
    console.log('Page not found');
  } else {
    console.error('API Error:', error.message);
  }
}

aggregate

Aggregates documents by grouping them (if groupBy is provided) and applying multiple operations. Different operations (e.g. sum, countDistinct, avg, etc.) are supported.

Parameters

Name	Type	Required
tenantId	string	Yes
aggregationRequest	AggregationRequest	Yes
parentTenantId	string	No
includeStats	boolean	No

Response

Returns: AggregationResponse

Example

aggregate Example

Copy

const tenantId: string = "tenant_42";
const parentTenantId: string = "org_parent_7";
const includeStats: boolean = true;
const aggregationRequest: AggregationRequest = {
  operation: { type: "COUNT", field: "commentId" },
  groupBy: ["postId"],
  filters: { predicates: [{ field: "status", operator: "EQ", value: { stringValue: "approved" } }] },
  sort: [{ field: "count", direction: "DESC" }],
  limit: 50
};
const result: AggregationResponse = await aggregate(tenantId, aggregationRequest, parentTenantId, includeStats);

getAuditLogs

Parameters

Name	Type	Required
tenantId	string	Yes
limit	number	No
skip	number	No
order	SORTDIR	No
after	number	No
before	number	No

Response

Returns: GetAuditLogs200Response

Example

getAuditLogs Example

Copy

const tenantId: string = 'tenant_9c4f3a7b';
const limit: number = 50;
const skip: number = 0;
const order: SORTDIR = SORTDIR.DESC;
const after: number = 1672444800;
const before: number = 1675036800;
const response: GetAuditLogs200Response = await getAuditLogs(tenantId, limit, skip, order, after, before);

blockFromCommentPublic

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
publicBlockFromCommentParams	PublicBlockFromCommentParams	Yes
sso	string	No

Response

Returns: BlockFromCommentPublic200Response

Example

blockFromCommentPublic Example

Copy

const tenantId: string = "tenant_9f4b2a";
const commentId: string = "comment_3a7e1c";
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: "Repeated harassment toward other users",
  durationHours: 168,
  notifyCommenter: true
};
const sso: string = "eyJhbGciOiJIUzI1NiIkpXVCJ9.sso_example_token";
const result: BlockFromCommentPublic200Response = await blockFromCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

unBlockCommentPublic

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
publicBlockFromCommentParams	PublicBlockFromCommentParams	Yes
sso	string	No

Response

Returns: UnBlockCommentPublic200Response

Example

unBlockCommentPublic Example

Copy

async function demoUnblock(): Promise<void> {
  const tenantId: string = 'tenant_12345';
  const commentId: string = 'cmt_98765';
  const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
    unblockReason: 'User appeal accepted after review',
    moderatorId: 'mod_67890',
    liftedAt: new Date().toISOString()
  };
  const sso: string = 'sso_tok_prod_01ab2c3d';
  const result: UnBlockCommentPublic200Response = await unBlockCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);
  console.log(result);
}
demoUnblock();

checkedCommentsForBlocked

Parameters

Name	Type	Required
tenantId	string	Yes
commentIds	string	Yes
sso	string	No

Response

Returns: CheckedCommentsForBlocked200Response

Example

checkedCommentsForBlocked Example

Copy

const tenantId: string = "tenant_98431";
const commentIds: string = "cmt_2048,cmt_2049,cmt_2050";
const resultWithoutSso: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds);
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sample.signature";
const resultWithSso: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds, ssoToken);

blockUserFromComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
blockFromCommentParams	BlockFromCommentParams	Yes
userId	string	No
anonUserId	string	No

Response

Returns: BlockFromCommentPublic200Response

Example

blockUserFromComment Example

Copy

const tenantId: string = 'tenant_acme_01';
const id: string = 'cmt_20260112_7b9f';
const blockFromCommentParams: BlockFromCommentParams = {
  reason: 'Repeated spam links',
  durationDays: 90,
  blockReplies: true,
  notifyCommenter: true
};
const userId: string = 'user_7f3e9';
const result: BlockFromCommentPublic200Response = await blockUserFromComment(tenantId, id, blockFromCommentParams, userId);

createCommentPublic

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
broadcastId	string	Yes
commentData	CommentData	Yes
sessionId	string	No
sso	string	No

Response

Returns: CreateCommentPublic200Response

Example

createCommentPublic Example

Copy

const tenantId: string = "tenant_92b4f3";
const urlId: string = "https://www.news-site.com/articles/2026/typescript-updates";
const broadcastId: string = "broadcast_live_20260112";
const commentData: CommentData = {
  body: "Great updates — the stricter inference and tooling improvements will help a lot.",
  author: { name: "Jordan Lee", avatarUrl: "https://avatars.example.com/jordan.jpg" },
  metadata: { client: "web", editor: "rich-text" }
};
const sessionId: string = "sess_7a9c2d4b";
const sso: string = "sso_token_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9";
const result: CreateCommentPublic200Response = await createCommentPublic(tenantId, urlId, broadcastId, commentData, sessionId, sso);

deleteComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
contextUserId	string	No
isLive	boolean	No

Response

Returns: DeleteComment200Response

Example

deleteComment Example

Copy

async function run(): Promise<void> {
  const result: DeleteComment200Response = await deleteComment(
    'acme-corp-tenant-01',
    'comment-9f2b3c',
    'user-4827',
    true
  );
  console.log(result);
}
run();

deleteCommentPublic

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
editKey	string	No
sso	string	No

Response

Returns: DeleteCommentPublic200Response

Example

deleteCommentPublic Example

Copy

const tenantId: string = "acme-newsroom-tenant-001";
const commentId: string = "cmt_20260112_9f2b3a";
const broadcastId: string = "homepage-article-452";
const editKey: string | undefined = "edit_7d3f6a9b";
const sso: string | undefined = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature";
const result: DeleteCommentPublic200Response = await deleteCommentPublic(
  tenantId,
  commentId,
  broadcastId,
  editKey,
  sso
);

deleteCommentVote

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
voteId	string	Yes
urlId	string	Yes
broadcastId	string	Yes
editKey	string	No
sso	string	No

Response

Returns: DeleteCommentVote200Response

Example

deleteCommentVote Example

Copy

const tenantId: string = 'tenant_1034';
const commentId: string = 'cmt_20260111_784';
const voteId: string = 'vote_7782';
const urlId: string = 'article-2026-01-11-new-feature';
const broadcastId: string = 'broadcast_2026_01_11_live';
const editKey: string = 'edk_9f8e7d6c';
const sso: string = 'sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const result: DeleteCommentVote200Response = await deleteCommentVote(tenantId, commentId, voteId, urlId, broadcastId, editKey, sso);

flagComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
userId	string	No
anonUserId	string	No

Response

Returns: FlagComment200Response

Example

flagComment Example

Copy

const tenantId: string = 'tenant_9d3f2b';
const commentId: string = 'comment_4a7c1e';
const userId: string = 'user_8234'; // optional authenticated user id
const flaggedResponse: FlagComment200Response = await flagComment(tenantId, commentId, userId);

getComment

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetComment200Response

Example

getComment Example

Copy

const tenantId: string = 'acme-tenant-42';
const commentId: string = 'b3d1f9c2-7e8a-4d2e-9a1b-6c2e9f8a1234';
const commentResponse: GetComment200Response = await getComment(tenantId, commentId);
const apiComment: APIComment | undefined = (commentResponse as { comment?: APIComment }).comment;
const firstBadge: CommentUserBadgeInfo | undefined = apiComment?.user?.badges?.[0];

getComments

Parameters

Name	Type	Required
tenantId	string	Yes
page	number	No
limit	number	No
skip	number	No
asTree	boolean	No
skipChildren	number	No
limitChildren	number	No
maxTreeDepth	number	No
urlId	string	No
userId	string	No
anonUserId	string	No
contextUserId	string	No
hashTag	string	No
parentId	string	No
direction	SortDirections	No

Response

Returns: GetComments200Response

Example

getComments Example

Copy

const commentsResponse: GetComments200Response = await getComments(
  'tenant_abc123',
  2,
  25,
  0,
  true,
  1,
  3,
  3,
  'article-2026',
  'user_42',
  undefined,
  undefined,
  '#feature-release',
  'cmt_987654'
);

getCommentsPublic

req tenantId urlId

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
page	number	No
direction	SortDirections	No
sso	string	No
skip	number	No
skipChildren	number	No
limit	number	No
limitChildren	number	No
countChildren	boolean	No
fetchPageForCommentId	string	No
includeConfig	boolean	No
countAll	boolean	No
includei10n	boolean	No
locale	string	No
modules	string	No
isCrawler	boolean	No
includeNotificationCount	boolean	No
asTree	boolean	No
maxTreeDepth	number	No
useFullTranslationIds	boolean	No
parentId	string	No
searchText	string	No
hashTags	Array	No
userId	string	No
customConfigStr	string	No
afterCommentId	string	No
beforeCommentId	string	No

Response

Returns: GetCommentsPublic200Response

Example

getCommentsPublic Example

Copy

const response: GetCommentsPublic200Response = await getCommentsPublic(
  'tenant_7f3a2c',
  'https://blog.example.com/posts/2026/new-features',
  1,
  'DESC',
  'sso_jwt_eyJhbGciOiJIUzI1Ni',
  0,
  0,
  25,
  5,
  true,
  undefined,
  true,
  false,
  true,
  'en-US',
  'reactions,moderation',
  false,
  true,
  true,
  3,
  false,
  undefined,
  'new features release',
  ['release', 'feature'],
  'user_98765',
  '{"highlightThreads":true}',
  undefined,
  undefined
);

getCommentText

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
editKey	string	No
sso	string	No

Response

Returns: GetCommentText200Response

Example

getCommentText Example

Copy

(async () => {
  const tenantId: string = "tenant_98765";
  const commentId: string = "cmt_54321";
  const editKey: string = "edit_1a2b3c4d";
  const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fake.payload";
  const commentTextBasic: GetCommentText200Response = await getCommentText(tenantId, commentId);
  const commentTextWithAuth: GetCommentText200Response = await getCommentText(tenantId, commentId, editKey, sso);
})();

getCommentVoteUserNames

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
dir	number	Yes
sso	string	No

Response

Returns: GetCommentVoteUserNames200Response

Example

getCommentVoteUserNames Example

Copy

async function example(): Promise<void> {
  const tenantId: string = 'acme_corp';
  const commentId: string = 'cmt_000123456';
  const dirDownvote: number = -1;
  const voteUserNamesDown: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dirDownvote);
  const dirUpvote: number = 1;
  const ssoToken: string = 'sso:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
  const voteUserNamesUp: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dirUpvote, ssoToken);
  console.log(voteUserNamesDown, voteUserNamesUp);
}
example();

lockComment

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
sso	string	No

Response

Returns: LockComment200Response

Example

lockComment Example

Copy

const tenantId: string = 'tenant_acme_42';
const commentId: string = 'cmt_9f3b2a';
const broadcastId: string = 'broadcast_2026-01-12_live';
const sso: string | undefined = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature';
const result: LockComment200Response = await lockComment(tenantId, commentId, broadcastId, sso);

pinComment

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
sso	string	No

Response

Returns: PinComment200Response

Example

pinComment Example

Copy

(async () => {
  const tenantId: string = "tenant_1278";
  const commentId: string = "cmt_84b3f";
  const broadcastId: string = "brd_live_20260112";
  const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fake.signature";
  const pinnedWithSso: PinComment200Response = await pinComment(tenantId, commentId, broadcastId, ssoToken);
  const pinnedWithoutSso: PinComment200Response = await pinComment(tenantId, commentId, broadcastId);
  console.log(pinnedWithSso, pinnedWithoutSso);
})();

saveComment

Parameters

Name	Type	Required
tenantId	string	Yes
createCommentParams	CreateCommentParams	Yes
isLive	boolean	No
doSpamCheck	boolean	No
sendEmails	boolean	No
populateNotifications	boolean	No

Response

Returns: SaveComment200Response

Example

saveComment Example

Copy

const tenantId: string = "tenant_92b3c";
const mention: CommentUserMentionInfo = { userId: "u842", displayName: "Alex Chen" };
const hashtag: CommentUserHashTagInfo = { tag: "performance" };
const createCommentParams: CreateCommentParams = {
  threadId: "article-frontend-performance-2026",
  content: "Performance improvements look great — shipped this in prod and saw a 12% render time reduction.",
  authorName: "Jordan Harper",
  authorEmail: "jordan.harper@example.com",
  mentions: [mention],
  hashtags: [hashtag]
};
const result: SaveComment200Response = await saveComment(tenantId, createCommentParams, true, true, false, true);

saveCommentsBulk

Parameters

Name	Type	Required
tenantId	string	Yes
createCommentParams	Array	Yes
isLive	boolean	No
doSpamCheck	boolean	No
sendEmails	boolean	No
populateNotifications	boolean	No

Response

Returns: Array<SaveComment200Response

Example

saveCommentsBulk Example

Copy

const tenantId: string = 'tenant_acme_922';
const mention: CommentUserMentionInfo = { userId: 'u-204', displayName: 'Maria Gomez', username: 'maria.g' };
const hashtag: CommentUserHashTagInfo = { tag: 'frontend', indices: [45, 53] };
const createCommentParams: Array<CreateCommentParams> = [
  {
    content: 'I replaced the legacy DOM manipulation with a small component — performance improved by ~30%.',
    authorName: 'Samuel Park',
    authorEmail: 'samuel.park@devteam.io',
    permalink: '/guides/performance-tuning',
    createdAt: '2026-01-11T09:15:00Z',
    userMentions: [mention],
    userHashtags: [hashtag]
  }
];
const responses: Array<SaveComment200Response> = await saveCommentsBulk(tenantId, createCommentParams, true, true, false, true);

setCommentText

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
commentTextUpdateRequest	CommentTextUpdateRequest	Yes
editKey	string	No
sso	string	No

Response

Returns: SetCommentText200Response

Example

setCommentText Example

Copy

const tenantId: string = "tenant_prod_81f4b3";
const commentId: string = "cmt_9a2f4e7b";
const broadcastId: string = "broadcast_2026_01_12_live";
const mention: CommentUserMentionInfo = { userId: "user_123", displayName: "Jane Doe" };
const hashtag: CommentUserHashTagInfo = { tag: "product-feedback" };
const commentTextUpdateRequest: CommentTextUpdateRequest = {
  text: "Thanks for the update — tagging @Jane Doe for visibility. #product-feedback",
  mentions: [mention],
  hashtags: [hashtag]
};
const editKey: string = "editkey_5f6b7c9d";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature";
const result: SetCommentText200Response = await setCommentText(tenantId, commentId, broadcastId, commentTextUpdateRequest, editKey, sso);

unBlockUserFromComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
unBlockFromCommentParams	UnBlockFromCommentParams	Yes
userId	string	No
anonUserId	string	No

Response

Returns: UnBlockCommentPublic200Response

Example

unBlockUserFromComment Example

Copy

const tenantId: string = "tenant_7b3f2c9a";
const commentId: string = "comment_9d4a1f2b";
const unBlockFromCommentParams: UnBlockFromCommentParams = {
  reason: "User submitted successful appeal; block removed",
  moderatorId: "mod_jane_doe",
  effectiveAt: new Date().toISOString()
};
const userId: string = "user_5a8f3e21";
const anonUserId: string = "anon_2f7d9c88";
const result: UnBlockCommentPublic200Response = await unBlockUserFromComment(
  tenantId,
  commentId,
  unBlockFromCommentParams,
  userId,
  anonUserId
);

unFlagComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
userId	string	No
anonUserId	string	No

Response

Returns: FlagComment200Response

Example

unFlagComment Example

Copy

const tenantId: string = "tenant_3f8b1a4c";
const id: string = "comment_5d7a2b9e";
const userId: string = "moderator_1024";
const result: FlagComment200Response = await unFlagComment(tenantId, id, userId);

unLockComment

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
sso	string	No

Response

Returns: LockComment200Response

Example

unLockComment Example

Copy

const tenantId: string = 'acme-tenant-7a1f2b';
const commentId: string = 'cmt-9d4e2f7a-12';
const broadcastId: string = 'bcast-2026-01-12-live';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1Njc4IiwiaWF0IjoxNjQwMDAwMDB9.signature';
const resultWithoutSso: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId);
const resultWithSso: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId, ssoToken);

unPinComment

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
broadcastId	string	Yes
sso	string	No

Response

Returns: PinComment200Response

Example

unPinComment Example

Copy

const tenantId: string = 'acme-tenant-7f3d';
const commentId: string = 'cmt_4b1e2a9c';
const broadcastId: string = 'live_20260112_nyc';
const sso: string = 'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyQGFjbWUuY29tIn0.r7hZQfK1Xk';
const result: PinComment200Response = await unPinComment(tenantId, commentId, broadcastId, sso);

updateComment

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updatableCommentParams	UpdatableCommentParams	Yes
contextUserId	string	No
doSpamCheck	boolean	No
isLive	boolean	No

Response

Returns: FlagCommentPublic200Response

Example

updateComment Example

Copy

const tenantId: string = "tenant_82b1c4";
const commentId: string = "cmt_9f3b2a1";
const updatableCommentParams: UpdatableCommentParams = {
  content: "Thanks — I've clarified the timeline and fixed the source link.",
  metadata: { editedBy: "moderator_12", editReason: "clarity" }
};
const contextUserId: string = "user_47a2b";
const doSpamCheck: boolean = true;
const isLive: boolean = false;
const result: FlagCommentPublic200Response = await updateComment(tenantId, commentId, updatableCommentParams, contextUserId, doSpamCheck, isLive);

voteComment

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
urlId	string	Yes
broadcastId	string	Yes
voteBodyParams	VoteBodyParams	Yes
sessionId	string	No
sso	string	No

Response

Returns: VoteComment200Response

Example

voteComment Example

Copy

const tenantId: string = "tenant_9f8d7c";
const commentId: string = "c_5a1b2c3d";
const urlId: string = "news/2026/01/clean-energy-policy";
const broadcastId: string = "broadcast_20260112_live";
const voteBodyParams: VoteBodyParams = { vote: "up", weight: 1 };
const sessionId: string | undefined = "session_xyz123";
const sso: string | undefined = "sso_jwt_token_eyJ";
const result: VoteComment200Response = await voteComment(tenantId, commentId, urlId, broadcastId, voteBodyParams, sessionId, sso);

addDomainConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
addDomainConfigParams	AddDomainConfigParams	Yes

Response

Returns: AddDomainConfig200Response

Example

addDomainConfig Example

Copy

const tenantId: string = 'tenant_6a9f8b2c';
const params: AddDomainConfigParams = {
  domain: 'comments.myproduct.io',
  allowedOrigins: ['https://www.myproduct.io', 'https://app.myproduct.io'],
  enforceHttps: true, // optional parameter
  description: 'Comments subdomain for product site'
};
const response: AddDomainConfig200Response = await addDomainConfig(tenantId, params);

deleteDomainConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
domain	string	Yes

Response

Returns: DeleteDomainConfig200Response

Example

deleteDomainConfig Example

Copy

const tenantId: string = 'tenant_8d3f2b4a9c';
const domain: string = 'comments.myproduct.io';
const response: DeleteDomainConfig200Response = await deleteDomainConfig(tenantId, domain);
// Optional post-delete handler (demonstrates optional parameter usage)
const onDeleted?: (res: DeleteDomainConfig200Response) => void = (res) => { /* notify admin, refresh UI */ };
onDeleted?.(response);

getDomainConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
domain	string	Yes

Response

Returns: GetDomainConfig200Response

Example

getDomainConfig Example

Copy

(async () => {
  const tenantId: string = 'acme-tenant-93b2';
  const domain: string = 'comments.acme.com';
  const domainConfig: GetDomainConfig200Response = await getDomainConfig(tenantId, domain);
  console.log(domainConfig);
})();

getDomainConfigs

Parameters

Name	Type	Required	Description
tenantId	string	Yes

Response

Returns: GetDomainConfigs200Response

Example

getDomainConfigs Example

Copy

// getDomainConfigs only requires tenantId; there are no optional parameters for this call
const tenantId: string = "acme-corp-001";
const domainConfigs: GetDomainConfigs200Response = await getDomainConfigs(tenantId);

patchDomainConfig

Parameters

Name	Type	Required
tenantId	string	Yes
domainToUpdate	string	Yes
patchDomainConfigParams	PatchDomainConfigParams	Yes

Response

Returns: GetDomainConfig200Response

Example

patchDomainConfig Example

Copy

const tenantId: string = 'tenant_acme_42';
const domainToUpdate: string = 'comments.acme-app.com';
const patchDomainConfigParams: PatchDomainConfigParams = {
  enableHttps: true,
  allowedOrigins: ['https://www.acme-app.com', 'https://app.acme-app.com'], // optional list
  redirectToPrimaryDomain: false // optional toggle
} as PatchDomainConfigParams;
const updatedConfig: GetDomainConfig200Response = await patchDomainConfig(tenantId, domainToUpdate, patchDomainConfigParams);

putDomainConfig

Parameters

Name	Type	Required
tenantId	string	Yes
domainToUpdate	string	Yes
updateDomainConfigParams	UpdateDomainConfigParams	Yes

Response

Returns: GetDomainConfig200Response

Example

putDomainConfig Example

Copy

const tenantId: string = "tenant_92b4c1a7";
const domainToUpdate: string = "blog.company-example.com";
const updateDomainConfigParams: UpdateDomainConfigParams = {
  enableComments: true,
  moderationMode: "pre-moderation",
  allowedOrigins: ["https://company-example.com", "https://studio.company-example.com"],
  // optional parameter demonstrated by including redirectToCanonical (may be omitted)
  redirectToCanonical: true
};
const response: GetDomainConfig200Response = await putDomainConfig(tenantId, domainToUpdate, updateDomainConfigParams);

createEmailTemplate

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createEmailTemplateBody	CreateEmailTemplateBody	Yes

Response

Returns: CreateEmailTemplate200Response

Example

createEmailTemplate Example

Copy

const tenantId: string = "tenant_7a9f2b3d";
const createEmailTemplateBody: CreateEmailTemplateBody = {
  name: "Comment Notification",
  subject: "New comment on your article: {{postTitle}}",
  htmlBody: "<p>{{commenterName}} left a comment:</p><blockquote>{{commentText}}</blockquote>",
  enabled: true,
  defaultLocale: "en-US",
  metadata: { createdBy: "admin@example.com", purpose: "notify_comment" } // optional extra data
};
const result: CreateEmailTemplate200Response = await createEmailTemplate(tenantId, createEmailTemplateBody);

deleteEmailTemplate

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteEmailTemplate Example

Copy

const tenantId: string = "tenant_4b2f6a-4b2f6a2d";
const templateId: string = "email_template_9f8b7c3e";
const result: FlagCommentPublic200Response = await deleteEmailTemplate(tenantId, templateId);
const status: APIStatus | undefined = result?.status

deleteEmailTemplateRenderError

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
errorId	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteEmailTemplateRenderError Example

Copy

const tenantId: string = "tenant_8f3b2a9c";
const id: string = "template_4a1c9f7e";
const errorId: string = "err_20260112_abc123";
const result: FlagCommentPublic200Response = await deleteEmailTemplateRenderError(tenantId, id, errorId);

getEmailTemplate

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetEmailTemplate200Response

Example

getEmailTemplate Example

Copy

(async () => {
  const tenantId: string = 'acme-enterprises-123';
  const id: string = 'welcome-email-template-v2';
  const locale: string | undefined = 'en-US'; // optional parameter example
  const template: GetEmailTemplate200Response = await getEmailTemplate(tenantId, id);
  console.log(template, locale);
})();

getEmailTemplateDefinitions

Parameters

Name	Type	Required	Description
tenantId	string	Yes

Response

Returns: GetEmailTemplateDefinitions200Response

Example

getEmailTemplateDefinitions Example

Copy

const tenantId: string = 'acme-enterprises-78f2';
const emailTemplates: GetEmailTemplateDefinitions200Response = await getEmailTemplateDefinitions(tenantId);

getEmailTemplateRenderErrors

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
skip	number	No

Response

Returns: GetEmailTemplateRenderErrors200Response

Example

getEmailTemplateRenderErrors Example

Copy

const tenantId: string = "tenant_7b3f2a9c";
const id: string = "tmpl_4f1b2c9e";
const skip: number = 25;
const result: GetEmailTemplateRenderErrors200Response = await getEmailTemplateRenderErrors(tenantId, id, skip);

getEmailTemplates

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetEmailTemplates200Response

Example

getEmailTemplates Example

Copy

const tenantId: string = 'tenant_8f4d2b7c';
const responseWithoutSkip: GetEmailTemplates200Response = await getEmailTemplates(tenantId);
const skip: number = 20;
const responseWithSkip: GetEmailTemplates200Response = await getEmailTemplates(tenantId, skip);

renderEmailTemplate

Parameters

Name	Type	Required
tenantId	string	Yes
renderEmailTemplateBody	RenderEmailTemplateBody	Yes
locale	string	No

Response

Returns: RenderEmailTemplate200Response

Example

renderEmailTemplate Example

Copy

const tenantId: string = 'acme-corp-7f3';
const renderEmailTemplateBody: RenderEmailTemplateBody = {
  templateId: 'new-comment-notification',
  recipientEmail: 'jane.doe@acme.com',
  variables: {
    commenterName: 'Samir Patel',
    commentText: 'I found this article really helpful — thanks for sharing!',
    threadUrl: 'https://acme.com/blog/123#comments'
  },
  includeUnsubscribeLink: true
};
const locale: string = 'en-US';
const response: RenderEmailTemplate200Response = await renderEmailTemplate(tenantId, renderEmailTemplateBody, locale);

updateEmailTemplate

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateEmailTemplateBody	UpdateEmailTemplateBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateEmailTemplate Example

Copy

const tenantId: string = 'acme-corp-tenant-01';
const id: string = 'email_tpl_42b7a9';
const updateEmailTemplateBody: UpdateEmailTemplateBody = {
  name: 'Comment Flag Notification',
  subject: 'A comment was flagged on acme.com',
  html: '<p>A comment by {{commenterName}} was flagged. Review at {{moderationUrl}}</p>',
  replyTo: 'noreply@acme.com', // optional field demonstrated
  enabled: true,
  customConfig: { priority: 'high' } // optional custom parameters
};
const response: FlagCommentPublic200Response = await updateEmailTemplate(tenantId, id, updateEmailTemplateBody);

getEventLog

req tenantId urlId userIdWS

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
userIdWS	string	Yes
startTime	number	Yes
endTime	number	Yes

Response

Returns: GetEventLog200Response

Example

getEventLog Example

Copy

const tenantId: string = 'tenant_7f9c3b';
const urlId: string = 'article-3f2a1c';
const userIdWS: string = 'ws-user-4521';
const startTime: number = Date.now() - 86_400_000; // 24 hours ago (ms)
const endTime: number = Date.now();
const endTimeOverride: number | undefined = undefined; // optional override
const endTimeToUse: number = endTimeOverride ?? endTime;
const response: GetEventLog200Response = await getEventLog(tenantId, urlId, userIdWS, startTime, endTimeToUse);

getGlobalEventLog

req tenantId urlId userIdWS

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
userIdWS	string	Yes
startTime	number	Yes
endTime	number	Yes

Response

Returns: GetEventLog200Response

Example

getGlobalEventLog Example

Copy

const tenantId: string = 'tenant_7a3f2b';
const urlId: string = 'site-homepage';
const optionalUrlId: string | undefined = undefined;
const userIdWS: string = 'ws-user-9843';
const startTime: number = Date.now() - 24 * 60 * 60 * 1000;
const endTime: number = Date.now();
const eventLog: GetEventLog200Response = await getGlobalEventLog(tenantId, optionalUrlId ?? urlId, userIdWS, startTime, endTime);

createFeedPost

Parameters

Name	Type	Required
tenantId	string	Yes
createFeedPostParams	CreateFeedPostParams	Yes
broadcastId	string	No
isLive	boolean	No
doSpamCheck	boolean	No
skipDupCheck	boolean	No

Response

Returns: CreateFeedPost200Response

Example

createFeedPost Example

Copy

const tenantId: string = "tenant_8f3b2c";
const createFeedPostParams: CreateFeedPostParams = {
  title: "Weekly product update",
  body: "We shipped performance improvements and a login fix. Please share feedback.",
  authorId: "user_72a1",
  externalId: "post-2026-01-12",
  media: [
    {
      type: "image",
      assets: [
        {
          url: "https://cdn.example.com/images/update-jan.jpg",
          width: 1200,
          height: 630,
          mimeType: "image/jpeg"
        } as FeedPostMediaItemAsset
      ]
    } as FeedPostMediaItem
  ],
  links: [
    { url: "https://example.com/releases/january", title: "Release notes" } as FeedPostLink
};
const broadcastId: string = "bcast_20260112";
const isLive: boolean = true;
const doSpamCheck: boolean = true;
const skipDupCheck: boolean = false;
const response: CreateFeedPost200Response = await createFeedPost(tenantId, createFeedPostParams, broadcastId, isLive, doSpamCheck, skipDupCheck);

createFeedPostPublic

Parameters

Name	Type	Required
tenantId	string	Yes
createFeedPostParams	CreateFeedPostParams	Yes
broadcastId	string	No
sso	string	No

Response

Returns: CreateFeedPostPublic200Response

Example

createFeedPostPublic Example

Copy

const tenantId: string = 'fastcomments-tenant-84';
const createFeedPostParams: CreateFeedPostParams = {
  title: 'Product Update — Performance Improvements',
  html: '<p>We deployed several backend optimizations reducing page load by ~30%.</p>',
  authorName: 'Engineering Team',
  published: true,
  media: [
    {
      url: 'https://cdn.fastcomments.example/assets/release-2-4.png',
      type: 'image',
      assets: [{ url: 'https://cdn.fastcomments.example/assets/release-2-4-thumb.png', width: 320 }]
    } as FeedPostMediaItem
  ] as FeedPostMediaItem[],
  links: [{ url: 'https://fastcomments.example/changelog/2.4', title: 'Full changelog' } as FeedPostLink]
} as CreateFeedPostParams;
const broadcastId: string = 'broadcast_2026_01_12_01';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const result: CreateFeedPostPublic200Response = await createFeedPostPublic(tenantId, createFeedPostParams, broadcastId, sso);

deleteFeedPostPublic

Parameters

Name	Type	Required
tenantId	string	Yes
postId	string	Yes
broadcastId	string	No
sso	string	No

Response

Returns: DeleteFeedPostPublic200Response

Example

deleteFeedPostPublic Example

Copy

const tenantId: string = 'tenant_8f3a2b9c-4d5e-6f7a-8b9c-0d1e2f3a4b5c';
const postId: string = 'post_74b3c9d2-1a6f-4e5d-9c3b-2a1e0f6d7c8b';
const broadcastId: string = 'broadcast_2026-01-12_01';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6InVzZXIxMjMiLCJleHAiOjE3MDAwMDAwMDB9.dummySignature12345';
const responseWithAll: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId, broadcastId, sso);
const responseRequiredOnly: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId);

getFeedPosts

req tenantId afterId

Parameters

Name	Type	Required
tenantId	string	Yes
afterId	string	No
limit	number	No
tags	Array	No

Response

Returns: GetFeedPosts200Response

Example

getFeedPosts Example

Copy

const tenantId: string = "tenant_5f6d9c";
const afterId: string | undefined = "post_20260110_abc123";
const limit: number = 50;
const tags: Array<string> = ["product-update", "security"];
const response: GetFeedPosts200Response = await getFeedPosts(tenantId, afterId, limit, tags);

getFeedPostsPublic

req tenantId afterId

Parameters

Name	Type	Required
tenantId	string	Yes
afterId	string	No
limit	number	No
tags	Array	No
sso	string	No
isCrawler	boolean	No
includeUserInfo	boolean	No

Response

Returns: GetFeedPostsPublic200Response

Example

getFeedPostsPublic Example

Copy

const tenantId: string = 'acme-corp-uk';
const afterId: string | undefined = 'post_20260110_123456';
const limit: number | undefined = 25;
const tags: string[] | undefined = ['product-updates', 'featured'];
const sso: string | undefined = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature';
const isCrawler: boolean | undefined = false;
const includeUserInfo: boolean | undefined = true;
const response: GetFeedPostsPublic200Response = await getFeedPostsPublic(tenantId, afterId, limit, tags, sso, isCrawler, includeUserInfo);

getFeedPostsStats

Parameters

Name	Type	Required
tenantId	string	Yes
postIds	Array	Yes
sso	string	No

Response

Returns: GetFeedPostsStats200Response

Example

getFeedPostsStats Example

Copy

const tenantId: string = 'acme-enterprises';
const postIds: string[] = ['a1f3e9b2-4d6c-41a2-9f3b-0c1234567890', 'b2d4c6e8-7f9a-42b1-a3c4-1d0987654321'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyQGFjbWUuY29tIiwiaWF0IjoxNjA5NDU2MDB9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const statsWithSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds, sso);
const statsWithoutSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds);

getUserReactsPublic

Parameters

Name	Type	Required
tenantId	string	Yes
postIds	Array	No
sso	string	No

Response

Returns: GetUserReactsPublic200Response

Example

getUserReactsPublic Example

Copy

const tenantId: string = 'acme-tenant-001';
const postIds: Array<string> = ['post-1001', 'post-1002'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const userReacts: GetUserReactsPublic200Response = await getUserReactsPublic(tenantId, postIds, sso);

reactFeedPostPublic

Parameters

Name	Type	Required
tenantId	string	Yes
postId	string	Yes
reactBodyParams	ReactBodyParams	Yes
isUndo	boolean	No
broadcastId	string	No
sso	string	No

Response

Returns: ReactFeedPostPublic200Response

Example

reactFeedPostPublic Example

Copy

const tenantId: string = "tenant_9b1f4c";
const postId: string = "post_c3f1a7";
const reactBody: ReactBodyParams = { reactionType: "like", emoji: "👍", userId: "user_42", timestamp: new Date().toISOString() };
const isUndo: boolean = false;
const broadcastId: string = "broadcast_20260112_001";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzQyIn0.signature";
const result: ReactFeedPostPublic200Response = await reactFeedPostPublic(tenantId, postId, reactBody, isUndo, broadcastId, sso);

updateFeedPost

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
feedPost	FeedPost	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateFeedPost Example

Copy

const tenantId: string = 'tenant-42-west';
const id: string = 'post-2026-01-12-007';
const mediaItem: FeedPostMediaItem = {
  type: 'image',
  caption: 'Team at launch event',
  assets: [{ url: 'https://cdn.fastcomments.example/photos/launch-1234.jpg', width: 1920, height: 1080 }]
};
const feedPost: FeedPost = {
  title: 'Product Launch Recap',
  body: 'We rolled out the new moderation features and performance improvements.',
  published: true,
  // optional parameters demonstrated:
  media: [mediaItem],
  links: [{ title: 'Full changelog', url: 'https://example.com/changelog/q1-2026' }]
};
const response: FlagCommentPublic200Response = await updateFeedPost(tenantId, id, feedPost);

updateFeedPostPublic

Parameters

Name	Type	Required
tenantId	string	Yes
postId	string	Yes
updateFeedPostParams	UpdateFeedPostParams	Yes
broadcastId	string	No
sso	string	No

Response

Returns: CreateFeedPostPublic200Response

Example

updateFeedPostPublic Example

Copy

const tenantId: string = "tenant_98f4c2";
const postId: string = "post_4a9b12";
const updateFeedPostParams: UpdateFeedPostParams = {
  title: "Weekly Product Update — Jan 12, 2026",
  body: "Released performance improvements (~30%) and fixed comment threading bug.",
  published: true,
  tags: ["release", "performance"]
};
const broadcastId: string = "broadcast_20260112_01";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampleSignature";
const result: CreateFeedPostPublic200Response = await updateFeedPostPublic(tenantId, postId, updateFeedPostParams, broadcastId, sso);

flagCommentPublic

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
isFlagged	boolean	Yes
sso	string	No

Response

Returns: FlagCommentPublic200Response

Example

flagCommentPublic Example

Copy

const tenantId: string = "tenant_8a3f2b4c";
const commentId: string = "cmt_9fc3e7a1";
const isFlagged: boolean = true;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: FlagCommentPublic200Response = await flagCommentPublic(tenantId, commentId, isFlagged, sso);

addHashTag

Parameters

Name	Type	Required	Description
tenantId	string	No
createHashTagBody	CreateHashTagBody	No

Response

Returns: AddHashTag200Response

Example

addHashTag Example

Copy

const tenantId: string = 'tenant_7b2f6c2b';
const createBody: CreateHashTagBody = {
  tag: 'feature-request',
  label: 'Feature Request',
  description: 'Requests for new functionality in the web client',
  isActive: true,
  visibility: 'public',
  allowedDomains: ['example.com', 'internal.example.com']
};
const result: AddHashTag200Response = await addHashTag(tenantId, createBody);
const resultWithoutTenant: AddHashTag200Response = await addHashTag(undefined, {
  tag: 'bug',
  label: 'Bug',
  description: 'Use for reproducible bugs reported by users',
  isActive: true,
  visibility: 'public'
});

addHashTagsBulk

Parameters

Name	Type	Required	Description
tenantId	string	No
bulkCreateHashTagsBody	BulkCreateHashTagsBody	No

Response

Returns: AddHashTagsBulk200Response

Example

addHashTagsBulk Example

Copy

(async () => {
  const tenantId: string = 'tenant_3f2b9a';
  const bulkCreateHashTagsBody: BulkCreateHashTagsBody = {
    tags: [
      { name: 'performance', description: 'Comments about site performance', visibleToModeratorsOnly: false },
      { name: 'feature-request', description: 'Requests for new features', visibleToModeratorsOnly: true }
    ]
  };
  const result: AddHashTagsBulk200Response = await addHashTagsBulk(tenantId, bulkCreateHashTagsBody);
  const resultWithNoTenant: AddHashTagsBulk200Response = await addHashTagsBulk(undefined, bulkCreateHashTagsBody);
  console.log(result, resultWithNoTenant);
})();

deleteHashTag

Parameters

Name	Type	Required
tag	string	Yes
tenantId	string	No
deleteHashTagRequest	DeleteHashTagRequest	No

Response

Returns: FlagCommentPublic200Response

Example

deleteHashTag Example

Copy

const tag: string = 'breaking-news';
const tenantId: string = 'tenant_42';
const deleteReq: DeleteHashTagRequest = { removedBy: 'moderator_jane', reason: 'off-topic for this community', deleteAssociatedComments: true } as DeleteHashTagRequest;
const result: FlagCommentPublic200Response = await deleteHashTag(tag, tenantId, deleteReq);

getHashTags

Parameters

Name	Type	Required	Description
tenantId	string	Yes
page	number	No

Response

Returns: GetHashTags200Response

Example

getHashTags Example

Copy

(async () => {
  const tenantId: string = "acme-corp-7a9f";
  const tagsPage1: GetHashTags200Response = await getHashTags(tenantId);
  const tagsPage2: GetHashTags200Response = await getHashTags(tenantId, 2);
  console.log(tagsPage1, tagsPage2);
})();

patchHashTag

Parameters

Name	Type	Required
tag	string	Yes
tenantId	string	No
updateHashTagBody	UpdateHashTagBody	No

Response

Returns: PatchHashTag200Response

Example

patchHashTag Example

Copy

const tag: string = 'release-2026';
const tenantId: string = 'tenant_42';
const updateHashTagBody: UpdateHashTagBody = {
  displayName: 'Release 2026',
  description: 'Discussions and notes for the 2026 product release',
  isActive: true
};
const result: PatchHashTag200Response = await patchHashTag(tag, tenantId, updateHashTagBody);

createModerator

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createModeratorBody	CreateModeratorBody	Yes

Response

Returns: CreateModerator200Response

Example

createModerator Example

Copy

const tenantId: string = "tenant_prod_us-east_01";
const createModeratorBody: CreateModeratorBody = {
  email: "maria.lopez+mod@fastcompany.com",
  username: "mlopez_mod",
  displayName: "Maria Lopez",
  roles: ["content_moderator"],
  notifyOnReports: true,
  metadata: { region: "us-east", team: "community" }
};
const result: CreateModerator200Response = await createModerator(tenantId, createModeratorBody);

deleteModerator

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
sendEmail	string	No

Response

Returns: FlagCommentPublic200Response

Example

deleteModerator Example

Copy

const tenantId: string = 'acme-tenant-987';
const moderatorId: string = 'mod-78b2c9a4-3f1e-4d6a';
const sendEmail: string = 'true';
const result: FlagCommentPublic200Response = await deleteModerator(tenantId, moderatorId, sendEmail);

getModerator

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetModerator200Response

Example

getModerator Example

Copy

const tenantId: string = "tenant_eu_4f8d2b9e";
const maybeModeratorId: string | undefined = "mod_91c3b7a2"; // optional source (could be undefined)
const moderator: GetModerator200Response = await getModerator(tenantId, maybeModeratorId!);

getModerators

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetModerators200Response

Example

getModerators Example

Copy

const tenantId: string = "tenant_corp_7f9b2a";
const moderatorsPage1: GetModerators200Response = await getModerators(tenantId);
const skip: number = 50;
const moderatorsPage2: GetModerators200Response = await getModerators(tenantId, skip);

sendInvite

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
fromName	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

sendInvite Example

Copy

const tenantId: string = 'acme-tenant-004';
const id: string = 'comment_9b7f3a2c';
const fromName: string = 'María Hernández';
const response: FlagCommentPublic200Response = await sendInvite(tenantId, id, fromName);

updateModerator

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateModeratorBody	UpdateModeratorBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateModerator Example

Copy

const tenantId: string = '4f8a9c2e-3b6d-4d9e-8c2f-1a2b3c4d5e6f';
const id: string = 'mod_92a7c4';
const updateModeratorBodyMinimal: UpdateModeratorBody = { displayName: 'Sophia Patel' };
const updateModeratorBodyWithOptional: UpdateModeratorBody = {
  displayName: 'Sophia Patel',
  email: 'sophia.patel@newsroom.example',
  permissions: ['remove_comments', 'ban_user'],
  notifyOnFlag: true // optional parameter demonstrated
};
const result: FlagCommentPublic200Response = await updateModerator(tenantId, id, updateModeratorBodyWithOptional);

deleteNotificationCount

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteNotificationCount Example

Copy

const tenantId: string = 'tenant_7f3a1b2c4d9e';
const notificationId: string = 'notif_8c9d0a1b2f3e4b7';
const result: FlagCommentPublic200Response = await deleteNotificationCount(tenantId, notificationId);

getCachedNotificationCount

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetCachedNotificationCount200Response

Example

getCachedNotificationCount Example

Copy

const tenantId: string = 'acme-tenant-01';
const baseNotificationId: string = 'notif-000123';
const idSuffix: string | undefined = undefined; // optional parameter example
const notificationId: string = idSuffix ? `${baseNotificationId}-${idSuffix}` : baseNotificationId;
const result: GetCachedNotificationCount200Response = await getCachedNotificationCount(tenantId, notificationId);
console.log(result);

getNotificationCount

Parameters

Name	Type	Required
tenantId	string	Yes
userId	string	No
urlId	string	No
fromCommentId	string	No
viewed	boolean	No
type	string	No

Response

Returns: GetNotificationCount200Response

Example

getNotificationCount Example

Copy

const tenantId: string = 'tenant_8a9b7c';
const userId: string = 'user_42b3c';
const urlId: string = 'https://blog.example.com/posts/introducing-new-editor';
const fromCommentId: string | undefined = undefined;
const viewed: boolean = false;
const type: string = 'mention';
const result: GetNotificationCount200Response = await getNotificationCount(tenantId, userId, urlId, fromCommentId, viewed, type);

getNotifications

Parameters

Name	Type	Required
tenantId	string	Yes
userId	string	No
urlId	string	No
fromCommentId	string	No
viewed	boolean	No
type	string	No
skip	number	No

Response

Returns: GetNotifications200Response

Example

getNotifications Example

Copy

(async () => {
  const tenantId: string = 'tenant_8f3b1a2c';
  const userId: string = 'user_42';
  const urlId: string = 'https://news.example.com/articles/2026/01/11/comment-thread';
  const fromCommentId: string = 'cmt_9a7b';
  const viewed: boolean = false;
  const type: string = 'mention';
  const skip: number = 0;
  const response: GetNotifications200Response = await getNotifications(tenantId, userId, urlId, fromCommentId, viewed, type, skip);
  console.log(response);
})();

updateNotification

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateNotificationBody	UpdateNotificationBody	Yes
userId	string	No

Response

Returns: FlagCommentPublic200Response

Example

updateNotification Example

Copy

const tenantId: string = "tenant_86a7b3";
const id: string = "notif_20260112_01";
const userId: string = "moderator_42";
const updateNotificationBody: UpdateNotificationBody = {
  name: "Flagged comment alert",
  enabled: true,
  channels: ["email"],
  recipients: ["mod-team@news-site.com"],
  threshold: 1
};
(async () => {
  const result: FlagCommentPublic200Response = await updateNotification(tenantId, id, updateNotificationBody, userId);
  console.log(result);
})();

addPage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createAPIPageData	CreateAPIPageData	Yes

Response

Returns: AddPageAPIResponse

Example

addPage Example

Copy

const tenantId: string = "acme-corp-prod-01";
const createData: CreateAPIPageData = {
  url: "/docs/2026/comment-moderation",
  title: "Comment Moderation Guide",
  description: "Step-by-step instructions to configure moderation workflows for community posts.",
  language: "en-US", // optional field
  metadata: { productArea: "support", owner: "platform-team" } // optional field
};
const result: AddPageAPIResponse = await addPage(tenantId, createData);

deletePage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: DeletePageAPIResponse

Example

deletePage Example

Copy

const tenantId: string = 'tenant_7c1ab2ef';
const id: string = 'b5f9c3d0-12ab-4e6f-9a2c-3d4b5a6e7f8a';
const response: DeletePageAPIResponse = await deletePage(tenantId, id);

getPageByURLId

Parameters

Name	Type	Required	Description
tenantId	string	Yes
urlId	string	Yes

Response

Returns: GetPageByURLIdAPIResponse

Example

getPageByURLId Example

Copy

const tenantId: string = 'acme-corp-742';
const urlId: string = 'blog-article-9f4b2c';
const response: GetPageByURLIdAPIResponse = await getPageByURLId(tenantId, urlId);
const page: APIPage | undefined = response.page;
const pageId: string | undefined = page?.id

getPages

Parameters

Name	Type	Required	Description
tenantId	string	Yes

Response

Returns: GetPagesAPIResponse

Example

getPages Example

Copy

(async () => {
  const tenantId: string = 'tenant_8a7b3d2f';
  const result: GetPagesAPIResponse = await getPages(tenantId);
  const pages: APIPage[] = result.pages ?? [];
  const firstPageId: string | undefined = pages[0]?.id;
  console.log(`Tenant ${tenantId} has ${pages.length} pages; first page id: ${firstPageId}`);
})();

patchPage

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateAPIPageData	UpdateAPIPageData	Yes

Response

Returns: PatchPageAPIResponse

Example

patchPage Example

Copy

const tenantId: string = 'tenant_7f3b2a4c';
const pageId: string = 'page_9c1d8f7';
const updateAPIPageData: UpdateAPIPageData = {
  title: 'How to use FastComments with TypeScript',
  path: '/guides/fastcomments-typescript',
  isPublished: true,
  metadata: { author: 'Alex Martinez', tags: ['comments', 'typescript'] } // optional field included
};
const result: PatchPageAPIResponse = await patchPage(tenantId, pageId, updateAPIPageData);

deletePendingWebhookEvent

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deletePendingWebhookEvent Example

Copy

const tenantId: string = 'tenant_7f4e2b';
const pendingEventId: string = '9f7b6a8c-3b2a-4c0d-a8e5-1234567890ab';
const result: FlagCommentPublic200Response = await deletePendingWebhookEvent(tenantId, pendingEventId);
console.log(result);

getPendingWebhookEventCount

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	No
externalId	string	No
eventType	string	No
type	string	No
domain	string	No
attemptCountGT	number	No

Response

Returns: GetPendingWebhookEventCount200Response

Example

getPendingWebhookEventCount Example

Copy

(async () => {
  const tenantId: string = 'tenant_9c3b2b';
  const commentId: string = 'cmt_f4a1b2';
  const externalId: string = 'ext-789';
  const eventType: string = 'comment.created';
  const type: string = 'delivery';
  const domain: string = 'app.example.com';
  const attemptCountGT: number = 2;
  const result: GetPendingWebhookEventCount200Response = await getPendingWebhookEventCount(
    tenantId,
    commentId,
    externalId,
    eventType,
    type,
    domain,
    attemptCountGT
  );
  console.log(result);
})();

getPendingWebhookEvents

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	No
externalId	string	No
eventType	string	No
type	string	No
domain	string	No
attemptCountGT	number	No
skip	number	No

Response

Returns: GetPendingWebhookEvents200Response

Example

getPendingWebhookEvents Example

Copy

const tenantId: string = "tenant_78b2f1";
const commentId: string = "cmt_0042";
const eventType: string = "comment.created";
const domain: string = "blog.example.com";
const attemptCountGT: number = 1;
const skip: number = 0;
const pending: GetPendingWebhookEvents200Response = await getPendingWebhookEvents(
  tenantId,
  commentId,
  undefined, // externalId
  eventType,
  undefined, // type
  domain,
  attemptCountGT,
  skip
);

createQuestionConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createQuestionConfigBody	CreateQuestionConfigBody	Yes

Response

Returns: CreateQuestionConfig200Response

Example

createQuestionConfig Example

Copy

const tenantId: string = "tenant_live_7f8b3c2a";
const customOptions: QuestionConfigCustomOptionsInner[] = [
  { value: "under18", label: "Under 18" },
  { value: "18-24", label: "18-24" },
  { value: "25-34", label: "25-34", defaultSelected: true }
];
const createQuestionConfigBody: CreateQuestionConfigBody = {
  key: "age_range",
  label: "What is your age range?",
  required: false, // optional: demonstrate omitted vs included optional fields
  renderingType: QuestionRenderingType.Dropdown,
  options: customOptions,
  whenSave: QuestionWhenSave.Always
};
const result: CreateQuestionConfig200Response = await createQuestionConfig(tenantId, createQuestionConfigBody);

deleteQuestionConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteQuestionConfig Example

Copy

async function deleteIfPresent(tenantId: string, id?: string): Promise<FlagCommentPublic200Response | null> {
  if (!id) return null;
  const result: FlagCommentPublic200Response = await deleteQuestionConfig(tenantId, id);
  return result;
}
const tenantId: string = 'tenant_acme_001';
const optionalConfigId: string | undefined = 'qcfg_20260112_01';
(async (): Promise<void> => {
  const deleted: FlagCommentPublic200Response | null = await deleteIfPresent(tenantId, optionalConfigId);
  void deleted;
})();

getQuestionConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetQuestionConfig200Response

Example

getQuestionConfig Example

Copy

const tenantId: string = 'acme-corp-47';
const questionId: string = 'q-2026-01-12-01';
const result: GetQuestionConfig200Response = await getQuestionConfig(tenantId, questionId);
function summarizeConfig(cfg: GetQuestionConfig200Response, includeMetadata?: boolean): QuestionConfig | undefined {
  // includeMetadata is optional; implementation omitted for brevity
  return undefined;
}
const summarizedWithMeta: QuestionConfig | undefined = summarizeConfig(result, true);
const summarizedDefault: QuestionConfig | undefined = summarizeConfig(result);

getQuestionConfigs

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetQuestionConfigs200Response

Example

getQuestionConfigs Example

Copy

const tenantId: string = 'tenant-42a7b9';
const firstPage: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId);
const secondPage: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId, 50);

updateQuestionConfig

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateQuestionConfigBody	UpdateQuestionConfigBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateQuestionConfig Example

Copy

const tenantId: string = 'tenant-82b3a';
const id: string = 'qst-20260112';
const updateQuestionConfigBody: UpdateQuestionConfigBody = { label: 'Age verification', required: true, renderingType: 'singleChoice', customOptions: [{ value: '18-24', label: '18–24' }] } as UpdateQuestionConfigBody;
const result: FlagCommentPublic200Response = await updateQuestionConfig(tenantId, id, updateQuestionConfigBody);

createQuestionResult

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createQuestionResultBody	CreateQuestionResultBody	Yes

Response

Returns: CreateQuestionResult200Response

Example

createQuestionResult Example

Copy

const tenantId: string = "fc_tenant_7a3c_us-east-1";
const metaItem: MetaItem = { key: "referrer", value: "/blog/how-to-comment" };
const createQuestionResultBody: CreateQuestionResultBody = {
  questionId: "q_42",
  commenterId: "user_1984",
  answer: "yes",
  score: 4,
  meta: [metaItem] // optional metadata demonstrated
} as CreateQuestionResultBody;
const result: CreateQuestionResult200Response = await createQuestionResult(tenantId, createQuestionResultBody);

deleteQuestionResult

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteQuestionResult Example

Copy

const tenantId: string = 'acme-tenant-01';
const questionResultId: string = '6f1a2b3c-4d5e-6789-abcd-ef0123456789';
const deletedResult: FlagCommentPublic200Response = await deleteQuestionResult(tenantId, questionResultId);
console.log(deletedResult);

getQuestionResult

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetQuestionResult200Response

Example

getQuestionResult Example

Copy

const tenantId: string = "3fa85f64-5717-4562-b3fc-2c963f66afa6";
const questionId: string = "question_72f1b9c3a4";
const result: GetQuestionResult200Response = await getQuestionResult(tenantId, questionId);
console.log(result);

getQuestionResults

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	No
userId	string	No
startDate	string	No
questionId	string	No
questionIds	string	No
skip	number	No

Response

Returns: GetQuestionResults200Response

Example

getQuestionResults Example

Copy

const tenantId: string = 'tenant_42';
const urlId: string = 'news/2025/fastcomments-release';
const userId: string = 'user_8b7f3c';
const startDate: string = '2025-01-01T00:00:00Z';
const questionIds: string = 'q123,q124';
const skip: number = 20;
const result: GetQuestionResults200Response = await getQuestionResults(tenantId, urlId, userId, startDate, undefined, questionIds, skip);

updateQuestionResult

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateQuestionResultBody	UpdateQuestionResultBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateQuestionResult Example

Copy

const tenantId: string = 'tenant_84f2b9';
const id: string = 'question_3a7c1d';
const updateQuestionResultBody: UpdateQuestionResultBody = {
  result: { verdict: 'helpful', confidence: 0.92 },
  reviewer: { id: 'mod_102', name: 'Aisha Rahman' },
  notifyUser: true // optional parameter included
};
const response: FlagCommentPublic200Response = await updateQuestionResult(tenantId, id, updateQuestionResultBody);

aggregateQuestionResults

Parameters

Name	Type	Required
tenantId	string	Yes
questionId	string	No
questionIds	Array	No
urlId	string	No
timeBucket	AggregateTimeBucket	No
startDate	Date	No
forceRecalculate	boolean	No

Response

Returns: AggregateQuestionResults200Response

Example

aggregateQuestionResults Example

Copy

const tenantId: string = "tenant_9f3b7c2d";
const questionIds: Array<string> = ["q_prod_feature_vote", "q_ui_satisfaction"];
const urlId: string = "url_5f7a2c1e";
const startDate: Date = new Date("2025-01-01T00:00:00Z");
const forceRecalculate: boolean = true;
const result: AggregateQuestionResults200Response = await aggregateQuestionResults(
  tenantId,
  undefined,
  questionIds,
  urlId,
  undefined,
  startDate,
  forceRecalculate
);

bulkAggregateQuestionResults

Parameters

Name	Type	Required
tenantId	string	Yes
bulkAggregateQuestionResultsRequest	BulkAggregateQuestionResultsRequest	Yes
forceRecalculate	boolean	No

Response

Returns: BulkAggregateQuestionResults200Response

Example

bulkAggregateQuestionResults Example

Copy

const tenantId: string = "tenant_48d3a2b1";
const requestItem: BulkAggregateQuestionItem = {
  questionId: "q-7890",
  metric: "response_count",
  timeBuckets: [
    {
      start: "2025-01-01T00:00:00Z",
      end: "2025-01-07T23:59:59Z"
    }
  ]
};
const bulkAggregateQuestionResultsRequest: BulkAggregateQuestionResultsRequest = {
  items: [requestItem],
  includeTotals: true
};
const forceRecalculate: boolean = true;
const result: BulkAggregateQuestionResults200Response = await bulkAggregateQuestionResults(tenantId, bulkAggregateQuestionResultsRequest, forceRecalculate);

combineCommentsWithQuestionResults

Parameters

Name	Type	Required
tenantId	string	Yes
questionId	string	No
questionIds	Array	No
urlId	string	No
startDate	Date	No
forceRecalculate	boolean	No
minValue	number	No
maxValue	number	No
limit	number	No

Response

Returns: CombineCommentsWithQuestionResults200Response

Example

combineCommentsWithQuestionResults Example

Copy

const tenantId: string = 'tenant_abc123';
const questionIds: string[] = ['q_101', 'q_102'];
const startDate: Date = new Date('2025-01-01T00:00:00Z');
const limit: number = 200;
const result: CombineCommentsWithQuestionResults200Response = await combineCommentsWithQuestionResults({
  tenantId,
  questionIds,
  startDate,
  forceRecalculate: true,
  minValue: 0,
  maxValue: 100,
  limit
});

addSSOUser

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createAPISSOUserData	CreateAPISSOUserData	Yes

Response

Returns: AddSSOUserAPIResponse

Example

addSSOUser Example

Copy

const tenantId: string = 'acme-tenant-7f8c2d4b';
const createAPISSOUserData: CreateAPISSOUserData = {
  externalId: 'okta|00u1abcd2345EfGH',
  email: 'jane.doe@acme-corp.com',
  displayName: 'Jane Doe',
  avatarUrl: 'https://cdn.acme-corp.com/avatars/jane.jpg',
  sendWelcomeEmail: true,
  metadata: { department: 'Engineering', employeeId: 'E12345' }
};
const result: AddSSOUserAPIResponse = await addSSOUser(tenantId, createAPISSOUserData);

deleteSSOUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
deleteComments	boolean	No
commentDeleteMode	string	No

Response

Returns: DeleteSSOUserAPIResponse

Example

deleteSSOUser Example

Copy

const tenantId: string = 'tenant_8a3f4c2b-6d1a';
const id: string = 'sso_user_3f9a7b1d-22c4';
const deleteComments: boolean = true;
const commentDeleteMode: string = 'permanent';
const responseWithDeletion: DeleteSSOUserAPIResponse = await deleteSSOUser(tenantId, id, deleteComments, commentDeleteMode);
const responseWithoutDeletion: DeleteSSOUserAPIResponse = await deleteSSOUser(tenantId, id);

getSSOUserByEmail

Parameters

Name	Type	Required	Description
tenantId	string	Yes
email	string	Yes

Response

Returns: GetSSOUserByEmailAPIResponse

Example

getSSOUserByEmail Example

Copy

const tenantId: string = "tenant_fc_7a9d3b";
const email: string = "laura.powell@dailynews.com";
const response: GetSSOUserByEmailAPIResponse = await getSSOUserByEmail(tenantId, email);
const ssoUser: APISSOUser | undefined = response.user;
const ssoUserEmail: string | undefined = ssoUser?.email;

getSSOUserById

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetSSOUserByIdAPIResponse

Example

getSSOUserById Example

Copy

const tenantId: string = "fastcomments-enterprise-42";
const id: string = "sso_user_9f3b1c2d";
const result: GetSSOUserByIdAPIResponse = await getSSOUserById(tenantId, id);
const ssoUser: APISSOUser | undefined = result.user;
const email: string | undefined = ssoUser?.email;
console.log(email);

getSSOUsers

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetSSOUsers200Response

Example

getSSOUsers Example

Copy

const tenantId: string = 'tenant_4a9f3b2c-01';
const resultWithoutSkip: GetSSOUsers200Response = await getSSOUsers(tenantId);
const skip: number = 25;
const resultWithSkip: GetSSOUsers200Response = await getSSOUsers(tenantId, skip);

patchSSOUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateAPISSOUserData	UpdateAPISSOUserData	Yes
updateComments	boolean	No

Response

Returns: PatchSSOUserAPIResponse

Example

patchSSOUser Example

Copy

(async () => {
  const tenantId: string = 'tenant_acme_01';
  const id: string = 'ssouser_0a1b2c3d';
  const updateData: UpdateAPISSOUserData = {
    email: 'jane.doe@acme-corp.com',
    name: 'Jane Doe',
    provider: 'saml',
    externalId: 'CN=Jane Doe,OU=Users,DC=acme,DC=com'
  };
  const updateComments: boolean = true;
  const result: PatchSSOUserAPIResponse = await patchSSOUser(tenantId, id, updateData, updateComments);
})();

putSSOUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateAPISSOUserData	UpdateAPISSOUserData	Yes
updateComments	boolean	No

Response

Returns: PutSSOUserAPIResponse

Example

putSSOUser Example

Copy

const tenantId: string = "fastcomments_tenant_7f3a2b";
const id: string = "sso_user_4a9c21";
const updateData: UpdateAPISSOUserData = {
  email: "marija.kovacevic@example.com",
  displayName: "Marija K.",
  roles: ["moderator"],
  avatarUrl: "https://cdn.example.com/avatars/marija.jpg",
  externalId: "marija-kovacevic-01"
};
const updateComments: boolean = true;
const result: PutSSOUserAPIResponse = await putSSOUser(tenantId, id, updateData, updateComments);

createSubscription

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createAPIUserSubscriptionData	CreateAPIUserSubscriptionData	Yes

Response

Returns: CreateSubscriptionAPIResponse

Example

createSubscription Example

Copy

(async () => {
  const tenantId: string = "fc_tenant_7f3b2a";
  const subscriptionData: CreateAPIUserSubscriptionData = {
    userId: "user_84c9",
    planId: "pro_annual",
    startDate: "2026-01-15T12:00:00Z",
    autoRenew: true,
    paymentMethodId: "pm_visa_9876",
    trialEndsAt: "2026-02-15T12:00:00Z", // optional field demonstrated
    metadata: { signupSource: "marketing_campaign" } // optional field demonstrated
  };
  const result: CreateSubscriptionAPIResponse = await createSubscription(tenantId, subscriptionData);
  console.log(result);
})();

deleteSubscription

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
userId	string	No

Response

Returns: DeleteSubscriptionAPIResponse

Example

deleteSubscription Example

Copy

const responseWithoutUser: DeleteSubscriptionAPIResponse = await deleteSubscription('tenant_9f8b7a6c', 'sub_3a9d2e7b');
const responseWithUser: DeleteSubscriptionAPIResponse = await deleteSubscription('tenant_9f8b7a6c', 'sub_8b2c4f1d', 'user_47b2f9c1');

getSubscriptions

Parameters

Name	Type	Required	Description
tenantId	string	Yes
userId	string	No

Response

Returns: GetSubscriptionsAPIResponse

Example

getSubscriptions Example

Copy

const tenantId: string = 'tenant_8a7f3b2c';
const userId: string = 'user_4f1c9d6a';
const subscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId, userId);
const tenantOnlySubscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId);

getTenantDailyUsages

Parameters

Name	Type	Required
tenantId	string	Yes
yearNumber	number	No
monthNumber	number	No
dayNumber	number	No
skip	number	No

Response

Returns: GetTenantDailyUsages200Response

Example

getTenantDailyUsages Example

Copy

const tenantId: string = "tenant_89f3c2-prod";
const yearNumber: number = 2026;
const monthNumber: number = 1;
const skip: number = 0;
const usages: GetTenantDailyUsages200Response = await getTenantDailyUsages(tenantId, yearNumber, monthNumber, undefined, skip);

createTenantPackage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createTenantPackageBody	CreateTenantPackageBody	Yes

Response

Returns: CreateTenantPackage200Response

Example

createTenantPackage Example

Copy

const tenantId: string = "tenant_7f3b1a9c";
const tenantPackage: TenantPackage = { id: "pkg_001", name: "Premium Plan", seats: 100 };
const customConfig: CustomConfigParameters = { enableImages: true, maxImageSizeMb: 10 };
const createTenantPackageBody: CreateTenantPackageBody = {
  packageName: "Premium Plus",
  tenantPackage,
  customConfig,
  notes: "Enable advanced moderation and image uploads" // optional parameter demonstrated
};
const result: CreateTenantPackage200Response = await createTenantPackage(tenantId, createTenantPackageBody);

deleteTenantPackage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: FlagCommentPublic200Response

Example

deleteTenantPackage Example

Copy

const tenantId: string = 'fc-tenant-8a9c2b';
const packageId: string = 'pkg-47f3c9';
const result: FlagCommentPublic200Response = await deleteTenantPackage(tenantId, packageId);

getTenantPackage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetTenantPackage200Response

Example

getTenantPackage Example

Copy

const tenantId: string = 'tenant_westus_01';
const packageId: string = 'pkg_premium_annual_2026';
interface FetchOptions { includeArchived?: boolean }
const options: FetchOptions = { includeArchived: false };
const result: GetTenantPackage200Response = await getTenantPackage(tenantId, packageId);

getTenantPackages

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetTenantPackages200Response

Example

getTenantPackages Example

Copy

const tenantId: string = 'tenant_4f3a9c2d';
const skip: number = 25;
const packagesResponse: GetTenantPackages200Response = await getTenantPackages(tenantId);
const pagedPackagesResponse: GetTenantPackages200Response = await getTenantPackages(tenantId, skip);

replaceTenantPackage

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
replaceTenantPackageBody	ReplaceTenantPackageBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

replaceTenantPackage Example

Copy

const tenantId: string = 'tenant-9b72f2';
const packageId: string = 'pkg-prod-v2';
const replaceTenantPackageBody: ReplaceTenantPackageBody = {
  name: 'Premium Moderation Bundle',
  enabled: true,
  maxModerators: 4,
  // optional fields like "notes" or "trialExpiry" are intentionally omitted here
} as ReplaceTenantPackageBody;
const result: FlagCommentPublic200Response = await replaceTenantPackage(
  tenantId,
  packageId,
  replaceTenantPackageBody
);

updateTenantPackage

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateTenantPackageBody	UpdateTenantPackageBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateTenantPackage Example

Copy

const tenantId: string = 'tenant_8a4f1c9b';
const packageId: string = 'pkg_premium_v2';
const customConfig: CustomConfigParameters = { enableRichText: true, maxImagesPerComment: 5 };
const updateTenantPackageBody: UpdateTenantPackageBody = {
  name: 'Premium Moderation Package',
  enabled: true,
  description: 'Adds advanced spam rules, image moderation and priority support',
  customConfigParameters: customConfig
};
const result: FlagCommentPublic200Response = await updateTenantPackage(tenantId, packageId, updateTenantPackageBody);

createTenantUser

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createTenantUserBody	CreateTenantUserBody	Yes

Response

Returns: CreateTenantUser200Response

Example

createTenantUser Example

Copy

const tenantId: string = "tenant_9a8c7e4b";
const createTenantUserBody: CreateTenantUserBody = {
  email: "julia.smith@acme-corp.com",
  displayName: "Julia Smith",
  role: "moderator",
  password: "Str0ngP@ssword!23",
  sendInviteEmail: true, // optional parameter demonstrated
  locale: "en-US",
  metadata: { department: "Customer Success" }
};
const result: CreateTenantUser200Response = await createTenantUser(tenantId, createTenantUserBody);

deleteTenantUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
deleteComments	string	No
commentDeleteMode	string	No

Response

Returns: FlagCommentPublic200Response

Example

deleteTenantUser Example

Copy

const tenantId: string = 'tenant_8f3b2a9c';
const id: string = 'user_4e5f6a7b';
const deleteComments: string = 'true';
const commentDeleteMode: string = 'hard';
const result: FlagCommentPublic200Response = await deleteTenantUser(tenantId, id, deleteComments, commentDeleteMode);

getTenantUser

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetTenantUser200Response

Example

getTenantUser Example

Copy

const tenantId: string = "tenant_9f7d4b2a-1c3e";
const id: string = "user_6a12b3c4d5";
const includeProfile: boolean | undefined = true; // optional parameter example
const response: GetTenantUser200Response = await getTenantUser(tenantId, id);
console.log("Tenant user fetched", response);

getTenantUsers

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetTenantUsers200Response

Example

getTenantUsers Example

Copy

const tenantId: string = 'tenant_8f3b2c1a';
const skip: number = 50;
const firstPage: GetTenantUsers200Response = await getTenantUsers(tenantId);
const nextPage: GetTenantUsers200Response = await getTenantUsers(tenantId, skip);

replaceTenantUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
replaceTenantUserBody	ReplaceTenantUserBody	Yes
updateComments	string	No

Response

Returns: FlagCommentPublic200Response

Example

replaceTenantUser Example

Copy

const tenantId: string = "tenant_5f8b9a";
const id: string = "user_92bf21";
const replaceTenantUserBody: ReplaceTenantUserBody = {
  email: "jane.doe@acme-corp.com",
  displayName: "Jane Doe",
  externalId: "acme|12345",
  roles: ["commenter", "moderator"],
  isActive: true,
  metadata: { team: "product", location: "NYC" }
};
const updateComments: string = "Update historical comments to reflect new display name";
const result: FlagCommentPublic200Response = await replaceTenantUser(tenantId, id, replaceTenantUserBody, updateComments);

sendLoginLink

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
redirectURL	string	No

Response

Returns: FlagCommentPublic200Response

Example

sendLoginLink Example

Copy

const tenantId: string = 'tenant_acme_01';
const id: string = 'user_9f3b2a';
const redirectURL: string = 'https://app.example.com/onboard?source=login-email';
const result: FlagCommentPublic200Response = await sendLoginLink(tenantId, id, redirectURL);

updateTenantUser

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateTenantUserBody	UpdateTenantUserBody	Yes
updateComments	string	No

Response

Returns: FlagCommentPublic200Response

Example

updateTenantUser Example

Copy

const tenantId: string = 'tenant_84f3b2';
const id: string = 'user_7a9d1c';
const updateComments: string = 'Promoted to moderator and updated contact email';
const updateTenantUserBody: UpdateTenantUserBody = {
  email: 'jane.doe+mod@example.com',
  displayName: 'Jane D.',
  roles: ['moderator'],
  isBanned: false,
  metadata: { department: 'community' }
};
const result: FlagCommentPublic200Response = await updateTenantUser(tenantId, id, updateTenantUserBody, updateComments);

createTenant

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createTenantBody	CreateTenantBody	Yes

Response

Returns: CreateTenant200Response

Example

createTenant Example

Copy

const tenantId: string = "acme-corporation";
const billing: BillingInfo = { planId: "pro", billingContactEmail: "finance@acme-corp.com", currency: "USD" };
const domainConfig: APIDomainConfiguration = { primaryDomain: "comments.acme-corp.com", allowedDomains: ["acme-corp.com", "www.acme-corp.com"], enforceHttps: true };
const importedSites: ImportedSiteType[] = [{ siteId: "site-001", url: "https://blog.acme-corp.com", name: "Acme Blog" }]; // optional
const createBody: CreateTenantBody = { tenantName: "Acme Corporation", adminEmail: "admin@acme-corp.com", billingInfo: billing, domainConfiguration: domainConfig, importedSites, enableModeration: true };
const response: CreateTenant200Response = await createTenant(tenantId, createBody);

deleteTenant

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
sure	string	No

Response

Returns: FlagCommentPublic200Response

Example

deleteTenant Example

Copy

const tenantId: string = "tenant_7b3f1a9e";
const id: string = "flag_9c4d2b1a";
const sure: string = "yes_confirm_delete";
const result: FlagCommentPublic200Response = await deleteTenant(tenantId, id, sure);
console.log(result);

getTenant

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetTenant200Response

Example

getTenant Example

Copy

const tenantId: string = "tenant_acme_corp";
const id: string = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
interface GetOptions { includeDeleted?: boolean; locale?: string; }
const options: GetOptions = { locale: "en-US" };
const result: GetTenant200Response = await getTenant(tenantId, id);

getTenants

Parameters

Name	Type	Required
tenantId	string	Yes
meta	string	No
skip	number	No

Response

Returns: GetTenants200Response

Example

getTenants Example

Copy

(async () => {
  const tenantId: string = 'tenant_9f2d1b7c';
  const meta: string = 'include=domains,billing,customConfig';
  const skip: number = 20;
  const response: GetTenants200Response = await getTenants(tenantId, meta, skip);
  console.log(response);
})();

updateTenant

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateTenantBody	UpdateTenantBody	Yes

Response

Returns: FlagCommentPublic200Response

Example

updateTenant Example

Copy

const tenantId: string = "tenant_01H4ZQ7KABCD";
const id: string = "site_9f8e7d6c";
const apiDomainConfiguration: APIDomainConfiguration = {
  primaryDomain: "comments.acme.com",
  allowSubdomains: true
};
const billingInfo: BillingInfo = {
  planName: "Business",
  billingContactEmail: "billing@acme.com",
  seats: 25
};
const updateTenantBody: UpdateTenantBody = {
  displayName: "Acme Corporation Comments",
  apiDomainConfiguration,
  billingInfo, // optional parameter demonstrated
  enableModeration: true
};
const result: FlagCommentPublic200Response = await updateTenant(tenantId, id, updateTenantBody);

uploadImage

Upload and resize an image

Parameters

Name	Type	Required
tenantId	string	Yes
file	Blob	Yes
sizePreset	SizePreset	No
urlId	string	No

Response

Returns: UploadImageResponse

Example

uploadImage Example

Copy

const tenantId: string = 'tenant-4f3b2c9'
const file: Blob = new Blob([new Uint8Array([137,80,78,71,13,10,26,10])], { type: 'image/png' })
const sizePreset: SizePreset = { name: 'medium', maxWidth: 1024, maxHeight: 768 }
const urlId: string = 'article-2026-01-12'
const result: UploadImageResponse = await uploadImage(tenantId, file, sizePreset, urlId)

getUserBadgeProgressById

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetUserBadgeProgressById200Response

Example

getUserBadgeProgressById Example

Copy

(async () => {
  const tenantId: string = 'acme-inc-tenant-001';
  const userId: string = 'user-842391';
  const badgeProgress: GetUserBadgeProgressById200Response = await getUserBadgeProgressById(tenantId, userId);
  console.log(badgeProgress);
})();

getUserBadgeProgressByUserId

Parameters

Name	Type	Required	Description
tenantId	string	Yes
userId	string	Yes

Response

Returns: GetUserBadgeProgressById200Response

Example

getUserBadgeProgressByUserId Example

Copy

const tenantId: string = 'fastcomments-88a1';
const userId: string = 'user_5f4d2c';
const overrideUserId?: string = undefined; // optional override, demonstrate optional parameter usage
const targetUserId: string = overrideUserId ?? userId;
const result: GetUserBadgeProgressById200Response = await getUserBadgeProgressByUserId(tenantId, targetUserId);

getUserBadgeProgressList

Parameters

Name	Type	Required
tenantId	string	Yes
userId	string	No
limit	number	No
skip	number	No

Response

Returns: GetUserBadgeProgressList200Response

Example

getUserBadgeProgressList Example

Copy

const tenantId: string = "tenant_4f7b9c2e";
const userId: string = "user_9a12b3f6";
const limit: number = 25;
const skip: number = 0;
const result: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId, userId, limit, skip);

createUserBadge

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createUserBadgeParams	CreateUserBadgeParams	Yes

Response

Returns: CreateUserBadge200Response

Example

createUserBadge Example

Copy

const tenantId: string = 'tenant_9f8b6c';
const createUserBadgeParams: CreateUserBadgeParams = {
  name: 'Top Contributor',
  description: 'Awarded to users with 500+ helpful replies',
  imageUrl: 'https://cdn.fastcomments.com/badges/top-contributor.png',
  isActive: true,
  criteria: { minComments: 500, minUpvotes: 120 }, // optional criteria
  customConfig: { badgeColor: '#FFD700', displayOnProfile: true } // optional custom config
};
const result: CreateUserBadge200Response = await createUserBadge(tenantId, createUserBadgeParams);

deleteUserBadge

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: UpdateUserBadge200Response

Example

deleteUserBadge Example

Copy

const tenantId: string = "tenant_78b3c6d9";
const id: string = "badge-4a7b-11e6-80f5-76304dec7eb7";
const result: UpdateUserBadge200Response = await deleteUserBadge(tenantId, id);

getUserBadge

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetUserBadge200Response

Example

getUserBadge Example

Copy

async function demoFetch(tenantId: string, id: string, includeRelated?: boolean): Promise<GetUserBadge200Response> {
  const response: GetUserBadge200Response = await getUserBadge(tenantId, id);
  return response;
}
const tenantId: string = 'acme-enterprises-78';
const badgeId: string = '9f8b7c6d-5e4f-4012-8a3b-0c1d2e3f4a5b';
const badgeResponse: GetUserBadge200Response = await getUserBadge(tenantId, badgeId);

getUserBadges

Parameters

Name	Type	Required
tenantId	string	Yes
userId	string	No
badgeId	string	No
type	number	No
displayedOnComments	boolean	No
limit	number	No
skip	number	No

Response

Returns: GetUserBadges200Response

Example

getUserBadges Example

Copy

(async () => {
  const tenantId: string = 'site_8a12c9f';
  const displayedOnComments: boolean = true;
  const limit: number = 15;
  const skip: number = 0;
  const response: GetUserBadges200Response = await getUserBadges(tenantId, undefined, undefined, undefined, displayedOnComments, limit, skip);
  console.log(response);
})();

updateUserBadge

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
updateUserBadgeParams	UpdateUserBadgeParams	Yes

Response

Returns: UpdateUserBadge200Response

Example

updateUserBadge Example

Copy

const tenantId: string = "acme_corp_tenant_01";
const id: string = "badge_000198";
const updateUserBadgeParams: UpdateUserBadgeParams = {
  name: "Top Reviewer",
  description: "Awarded for 100+ helpful reviews",
  color: "#ffb347",
  imageUrl: "https://assets.acme.com/badges/top-reviewer.png",
  // optional: expiresAt can be omitted if badge is permanent
  expiresAt: "2027-01-01T00:00:00Z"
};
const updatedBadge: UpdateUserBadge200Response = await updateUserBadge(tenantId, id, updateUserBadgeParams);

getUserNotificationCount

Parameters

Name	Type	Required	Description
tenantId	string	Yes
sso	string	No

Response

Returns: GetUserNotificationCount200Response

Example

getUserNotificationCount Example

Copy

const tenantId: string = "tenant_3f8e9a2b-6c4d-4e0f-9d7a-12b3456c7890";
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1Njc4OSJ9.dummySignature";
const notificationCount: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId);
const notificationCountWithSso: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId, ssoToken);

getUserNotifications

Parameters

Name	Type	Required
tenantId	string	Yes
pageSize	number	No
afterId	string	No
includeContext	boolean	No
afterCreatedAt	number	No
unreadOnly	boolean	No
dmOnly	boolean	No
noDm	boolean	No
includeTranslations	boolean	No
sso	string	No

Response

Returns: GetUserNotifications200Response

Example

getUserNotifications Example

Copy

(async () => {
  const tenantId: string = "tenant_42";
  const pageSize: number = 25;
  const afterId: string = "notif_987654321";
  const includeContext: boolean = true;
  const afterCreatedAt: number = Date.now() - 7 * 24 * 60 * 60 * 1000;
  const unreadOnly: boolean = true;
  const dmOnly: boolean = false;
  const noDm: boolean = false;
  const includeTranslations: boolean = true;
  const sso: string = "sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9";
  const result: GetUserNotifications200Response = await getUserNotifications(tenantId, pageSize, afterId, includeContext, afterCreatedAt, unreadOnly, dmOnly, noDm, includeTranslations, sso);
  console.log(result);
})();

resetUserNotificationCount

Parameters

Name	Type	Required	Description
tenantId	string	Yes
sso	string	No

Response

Returns: ResetUserNotifications200Response

Example

resetUserNotificationCount Example

Copy

const tenantId: string = 'tenant_4a7f9c12';
const ssoToken: string = 'sso_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const resultWithSso: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId, ssoToken);
const resultWithoutSso: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId);

resetUserNotifications

Parameters

Name	Type	Required
tenantId	string	Yes
afterId	string	No
afterCreatedAt	number	No
unreadOnly	boolean	No
dmOnly	boolean	No
noDm	boolean	No
sso	string	No

Response

Returns: ResetUserNotifications200Response

Example

resetUserNotifications Example

Copy

const tenantId: string = 'tenant_8b3f4';
const afterId: string = 'notif_7a12';
const afterCreatedAt: number = Date.now() - 3_600_000;
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const noDm: boolean | undefined = undefined;
const sso: string = 'sso-token-0a1b2c3d';
const result: ResetUserNotifications200Response = await resetUserNotifications(
  tenantId,
  afterId,
  afterCreatedAt,
  unreadOnly,
  dmOnly,
  noDm,
  sso
);

updateUserNotificationCommentSubscriptionStatus

Enable or disable notifications for a specific comment.

Parameters

Name	Type	Required
tenantId	string	Yes
notificationId	string	Yes
optedInOrOut	UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum	Yes
commentId	string	Yes
sso	string	No

Response

Returns: UpdateUserNotificationStatus200Response

Example

updateUserNotificationCommentSubscriptionStatus Example

Copy

const tenantId: string = "tenant_84f3b2";
const notificationId: string = "notification_9a1c7";
const optedInOrOut: UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum = UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum.OptedIn;
const commentId: string = "comment_5d2e9";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampleSignature";
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationCommentSubscriptionStatus(tenantId, notificationId, optedInOrOut, commentId, sso);

updateUserNotificationPageSubscriptionStatus

Enable or disable notifications for a page. When users are subscribed to a page, notifications are created for new root comments, and also

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
url	string	Yes
pageTitle	string	Yes
subscribedOrUnsubscribed	UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum	Yes
sso	string	No

Response

Returns: UpdateUserNotificationStatus200Response

Example

updateUserNotificationPageSubscriptionStatus Example

Copy

const tenantId: string = "tenant_71b9f3c2";
const urlId: string = "post-2026-01-12-why-ts-is-great";
const url: string = "https://www.example-news.com/opinion/why-typescript-is-great";
const pageTitle: string = "Why TypeScript Is Great for Large Teams";
const subscribedOrUnsubscribed: UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum =
  UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum.SUBSCRIBED;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampleSignature";
const response: UpdateUserNotificationStatus200Response = await updateUserNotificationPageSubscriptionStatus(
  tenantId,
  urlId,
  url,
  pageTitle,
  subscribedOrUnsubscribed,
  sso
);

updateUserNotificationStatus

Parameters

Name	Type	Required
tenantId	string	Yes
notificationId	string	Yes
newStatus	UpdateUserNotificationStatusNewStatusEnum	Yes
sso	string	No

Response

Returns: UpdateUserNotificationStatus200Response

Example

updateUserNotificationStatus Example

Copy

const tenantId: string = "tenant_acme_corp_01";
const notificationId: string = "notif_20260112_84b2";
const newStatus: UpdateUserNotificationStatusNewStatusEnum = UpdateUserNotificationStatusNewStatusEnum.Read;
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature";
const resultWithoutSSO: UpdateUserNotificationStatus200Response = await updateUserNotificationStatus(tenantId, notificationId, newStatus);
const resultWithSSO: UpdateUserNotificationStatus200Response = await updateUserNotificationStatus(tenantId, notificationId, newStatus, ssoToken);

getUserPresenceStatuses

Parameters

Name	Type	Required
tenantId	string	Yes
urlIdWS	string	Yes
userIds	string	Yes

Response

Returns: GetUserPresenceStatuses200Response

Example

getUserPresenceStatuses Example

Copy

const tenantId: string = 'acme-news';
const urlIdWS: string = 'wss://ws.fastcomments.com/tenant/acme-news';
const userIds: string = 'user-7a9b,user-11f2';
type PresenceOptions = { includeInactive?: boolean };
const options: PresenceOptions = { includeInactive: true };
const presence: GetUserPresenceStatuses200Response = await getUserPresenceStatuses(tenantId, urlIdWS, userIds);

searchUsers

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
usernameStartsWith	string	No
mentionGroupIds	Array	No
sso	string	No

Response

Returns: SearchUsers200Response

Example

searchUsers Example

Copy

const tenantId: string = 'acme-corp-tenant-42';
const urlId: string = 'news-2026-01-12-top-story';
const usernameStartsWith: string = 'sara';
const mentionGroupIds: Array<string> = ['editors', 'community-managers'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.payload';
const result: SearchUsers200Response = await searchUsers(tenantId, urlId, usernameStartsWith, mentionGroupIds, sso);

getUser

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetUser200Response

Example

getUser Example

Copy

const tenantId: string = "acme-publishing-42";
const userIdOptional: string | undefined = "user_9d7b4c"; // may be undefined in some flows (optional)
const id: string = userIdOptional ?? "user_default_0001";
const result: GetUser200Response = await getUser(tenantId, id);
console.log(result);

createVote

Parameters

Name	Type	Required
tenantId	string	Yes
commentId	string	Yes
direction	CreateVoteDirectionEnum	Yes
userId	string	No
anonUserId	string	No

Response

Returns: VoteComment200Response

Example

createVote Example

Copy

(async () => {
  const tenantId: string = 'acme-tenant-812';
  const commentId: string = '5e8f8b7a-3d4b-4f1b-9a2e-1c9f2d6a7b8c';
  const direction: CreateVoteDirectionEnum = CreateVoteDirectionEnum.UP;
  const anonUserId: string = 'anon-84b9c2d';
  const voteResult: VoteComment200Response = await createVote(tenantId, commentId, direction, undefined, anonUserId);
  console.log(voteResult);
})();

deleteVote

Parameters

Name	Type	Required
tenantId	string	Yes
id	string	Yes
editKey	string	No

Response

Returns: DeleteCommentVote200Response

Example

deleteVote Example

Copy

const tenantId: string = 'tenant_7f3b21c9';
const id: string = 'vote_4a2d9f1b';
const editKey: string = 'edit_92b7c6a1';
const resultWithoutEditKey: DeleteCommentVote200Response = await deleteVote(tenantId, id);
const resultWithEditKey: DeleteCommentVote200Response = await deleteVote(tenantId, id, editKey);

getVotes

Parameters

Name	Type	Required	Description
tenantId	string	Yes
urlId	string	Yes

Response

Returns: GetVotes200Response

Example

getVotes Example

Copy

const tenantId: string = 'tenant_9f8b3c_prod';
const urlId: string = '/news/2026/typescript-ecosystem-update';
const votes: GetVotes200Response = await getVotes(tenantId, urlId);
// If an optional parameter existed, e.g. includeHidden, it might be used like:
// const votesWithHidden: GetVotes200Response = await getVotes(tenantId, urlId, { includeHidden: true });

getVotesForUser

Parameters

Name	Type	Required
tenantId	string	Yes
urlId	string	Yes
userId	string	No
anonUserId	string	No

Response

Returns: GetVotesForUser200Response

Example

getVotesForUser Example

Copy

const tenantId: string = 'tenant_acme_01';
const urlId: string = 'news/2026/01/12/product-launch';
const userId: string = 'user_9c3f2b';
const anonUserId: string = 'anon_d4e7a1';
const votesForUser: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, userId);
const votesForAnon: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, undefined, anonUserId);

Need Help?

If you encounter any issues or have questions about the JavaScript/TypeScript SDK, please:

Contributing

Contributions are welcome! Please visit the GitHub repository for contribution guidelines.

Language 🇺🇸 English

Getting Started

API Reference

Documentation

Usage

Aggregate

Audit Logs

Block From Comment

Check Blocked Comments

Comments

Domain Configs

Email Templates

Event Log

Feed Posts

Flag Comment

Hash Tags

Moderators

Notification Count

Notifications

Pages

Pending Webhook Events

Question Configs

Question Results

Question Results Aggregation

SSO Users

Subscriptions

Tenant Daily Usage

Tenant Packages

Tenant Users

Tenants

Upload Image

User Badge Progress

User Badges

User Notifications

User Presence Status

User Search

Users

Votes

FastComments JavaScript/TypeScript SDK

Repository

Installation

API Documentation

Browser vs Server Compatibility

Usage

Browser Usage (Client-Side)

Server Usage (Node.js)

Types Only Import

Using Individual API Classes

Browser Environment

Server Environment

Public vs Secured APIs

Example: Using Public API (browser-safe)

Example: Using Default API (server-side only)

SSO (Single Sign-On) Integration

Simple SSO (Server-Side Only)

Secure SSO (Server-Side, Recommended)

Using SSO from Browser (with Server-Generated Token)

SSO with Comment Creation

Common Use Cases

Getting Comments for a Page

Creating a Comment

Voting on a Comment

User Management (Requires API Key)

Live Events (Real-time Updates)

Page-Level Events

Subscribe to User Events

Getting userIdWS

Broadcast IDs

Error Handling

aggregate

Parameters

Response

Example

getAuditLogs

Parameters

Response

Example

blockFromCommentPublic

Parameters

Response