FastComments JavaScript/TypeScript SDK

This is the official JavaScript/TypeScript SDK for FastComments.

Official JavaScript/TypeScript SDK for the FastComments API

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);
  }
}

TypeScript Support

The SDK is written in TypeScript and provides complete type definitions for all API methods and response models:

// Import types from the default export (safe everywhere)
import type { 
  PublicComment, 
  CreateCommentParams, 
  GetCommentsPublic200Response 
} from 'fastcomments-sdk';

// Use with browser SDK
import { createFastCommentsBrowserSDK } from 'fastcomments-sdk/browser';

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

const comments: PublicComment[] = response.comments || [];

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

(async () => {
  const tenantId: string = 'tenant_12345';
  const parentTenantId: string = 'org_98765';
  const includeStats: boolean = true;
  const aggregationRequest: AggregationRequest = {
    predicates: [
      { field: 'createdAt', operator: 'gte', value: '2025-01-01T00:00:00Z' } as QueryPredicate
    ],
    operations: [
      { type: 'COUNT' as AggregationOpType, field: 'status' } as AggregationOperation
    ],
    sort: [{ field: 'count', direction: 'desc' }] as AggregationRequestSort,
    limit: 25
  };
  const response: AggregationResponse = await aggregate(tenantId, aggregationRequest, parentTenantId, includeStats);
  console.log(response);
})();

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_8f7b2c';
const limit: number = 100;
const skip: number = 0;
const order: SORTDIR = 'desc' as unknown as SORTDIR;
const after: number = Math.floor(Date.now() / 1000) - 7 * 24 * 60 * 60;
const result: GetAuditLogs200Response = await getAuditLogs(tenantId, limit, skip, order, after);

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_acme_001";
const commentId: string = "comment_9f8b7c";
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: "abusive_language",
  durationHours: 48,
  notifyCommenter: true,
  moderatorId: "moderator_42"
};
const sso: string = "sso_jwt_token_example_eyJhbGciOiJIUzI1Ni";
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

const tenantId: string = 'acme-tenant-84';
const commentId: string = 'cmt_987654321';
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: 'erroneous moderation',
  unblockedBy: 'moderator.jane.doe@acme.com',
  notes: 'User appeal validated; content restored',
  restoreReplies: true
};
const sso: string | undefined = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const result: UnBlockCommentPublic200Response = await unBlockCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

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_acme_42';
const commentIds: string = 'cmt_9a1b,cmt_4f3d';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyX2UxMjMiLCJpYXQiOjE2MzAwMDAwMDB9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const resultWithoutSSO: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds);
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 = 'acme-tenant-004';
const commentId: string = 'cmt-9f2a3b4c';
const blockFromCommentParams: BlockFromCommentParams = {
  reason: 'Repeated spam and promotional links',
  durationDays: 30,
  blockReplies: true,
  notifyModerators: true
};
const userId: string = 'user-000123';
const anonUserId: string = 'anon-8f7b2c';
const result: BlockFromCommentPublic200Response = await blockUserFromComment(tenantId, commentId, blockFromCommentParams, userId, anonUserId);

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_8b3f2a';
const urlId: string = 'articles/2025/11/solar-eclipse-grid-impact';
const broadcastId: string = 'broadcast_4721';
const commentData: CommentData = {
  body: 'Thanks for the in-depth coverage — wondering how local utilities are preparing for the eclipse day demand spike.',
  parentId: null,
  authorName: 'Jordan Meyers',
  authorEmail: 'j.meyers@newsdaily.com',
  mentions: [{ userId: 'user_2468', displayName: 'Alex Rivera' }],
  hashtags: [{ tag: 'solar-eclipse' }],
  metadata: { device: 'desktop', browser: 'Chrome/120' }
};
const sessionId: string = 'sess_9f3a2b7c';
const sso: string = 'sso.jwt.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 () => {
  const tenantId: string = "acme-corp-tenant-904";
  const id: string = "cmt_7f84d2a9";
  const contextUserId: string = "moderator_21";
  const isLive: boolean = true;
  const result: DeleteComment200Response = await deleteComment(tenantId, id, contextUserId, isLive);
  console.log(result);
})();

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 = 'tenant_42ac9b0f';
const commentId: string = 'cmt_5f8b7d3a9c';
const broadcastId: string = 'broadcast_2025-11-22T12:00:00Z';
const editKey: string = 'edk-3b9f7a2c';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fake.signature';
const result: DeleteCommentPublic200Response = await deleteCommentPublic(tenantId, commentId, broadcastId, editKey, sso);
console.log(result);

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

(async function run(): Promise<void> {
  const tenantId: string = "tenant_9f3d2b1a";
  const commentId: string = "comment_72a9f4e1";
  const voteId: string = "vote_8d1a3c5b";
  const urlId: string = "url_4b6d9e2f";
  const broadcastId: string = "broadcast_2025-11-22_01";
  const editKey: string | undefined = "editkey_6a1b2c3d";
  const sso: string | undefined = "sso_jwt_token_example";
  const result: DeleteCommentVote200Response = await deleteCommentVote(tenantId, commentId, voteId, urlId, broadcastId, editKey, sso);
  console.log(result);
})();

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-acme-01';
const commentId: string = 'cmt_5f8e9a2b';
const userId: string = 'user_1024';
const flaggedByUserResponse: FlagComment200Response = await flagComment(tenantId, commentId, userId);
const anonUserId: string = 'anon_9f2b3c';
const flaggedAnonResponse: FlagComment200Response = await flagComment(tenantId, commentId, undefined, anonUserId);

getComment

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetComment200Response

Example

getComment Example

Copy

const tenantId: string = "acme-corp-tenant-01";
const commentId: string | undefined = "cmt_9f8e7d6c5b4a"; // optional-style variable
const result: GetComment200Response = await getComment(tenantId, commentId!);

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

(async () => {
  const tenantId: string = 'tenant_12345';
  const result: GetComments200Response = await getComments(
    tenantId,
    1,                     // page
    25,                    // limit
    0,                     // skip
    true,                  // asTree
    0,                     // skipChildren
    3,                     // limitChildren
    5,                     // maxTreeDepth
    'news-article-20251122-abc123', // urlId
    'user_7890',           // userId
    'anon_456',            // anonUserId
    'moderator_101',       // contextUserId
    'discussion',          // hashTag
    'comment_9876',        // parentId
    SortDirections.DESC    // direction
  );
  console.log(result);
})();

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 tenantId: string = 'tenant_acme_001';
const urlId: string = 'article/2025/launch';
const page: number = 1;
const direction: SortDirections = 'newest' as unknown as SortDirections;
const limit: number = 25;
const limitChildren: number = 3;
const countChildren: boolean = true;
const includeConfig: boolean = true;
const response: GetCommentsPublic200Response = await getCommentsPublic(tenantId, urlId, page, direction, undefined, 0, 0, limit, limitChildren, countChildren, undefined, includeConfig);

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_8a3f4b2c';
  const commentId: string = 'cmt_9f4d3a2b';
  const resultBasic: GetCommentText200Response = await getCommentText(tenantId, commentId);
  const editKey: string = 'EK-4f3b2a1c';
  const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
  const resultWithOpts: GetCommentText200Response = await getCommentText(tenantId, commentId, editKey, sso);
  console.log(resultBasic, resultWithOpts);
})();

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 () => {
  const tenantId: string = 'fc_tenant_42';
  const commentId: string = 'cmt_9f8e7d6';
  const dir: number = 1;
  const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI0MjMiLCJlbWFpbCI6InVzZXJAZXhhbXBsZS5jb20ifQ.signature';
  const result: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dir);
  const resultWithSSO: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dir, sso);
  console.log(result, resultWithSSO);
})();

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_987';
const commentId: string = 'comment_10293';
const broadcastId: string = 'broadcast_live_20251122';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzEyMyIsImlhdCI6MTY5OTk5OTk5OX0.signature';
const lockResultNoSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId);
const lockResultWithSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId, ssoToken);

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_42f7a1";
  const commentId: string = "cmt-5e8d3c9a";
  const broadcastId: string = "bcast-20251122-01";
  const sso: string | undefined = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example_signature";
  const pinned: PinComment200Response = await pinComment(tenantId, commentId, broadcastId, sso);
  console.log(pinned);
})();

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_6f9a2b4c';
const createCommentParams: CreateCommentParams = {
  threadId: 'article_2025-11-22_001',
  content: 'Great analysis — I learned a lot from this breakdown.',
  userId: 'user_00421',
  userDisplayName: 'Aisha Patel',
  userEmail: 'aisha.patel@example.org',
  metadata: { device: 'iPhone', locale: 'en-US' }
};
const isLive: boolean = true;
const doSpamCheck: boolean = true;
const sendEmails: boolean = false;
const populateNotifications: boolean = true;
const result: SaveComment200Response = await saveComment(tenantId, createCommentParams, isLive, doSpamCheck, sendEmails, populateNotifications);

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

(async () => {
  const tenantId: string = 'tenant_7f4b21';
  const createCommentParams: CreateCommentParams[] = [
    {
      content: 'I learned a lot from this post. Thanks for the practical tips!',
      authorName: 'Sofia Ramos',
      authorEmail: 'sofia.ramos@techblog.com',
      userId: 'user_89237',
      threadId: 'article-2025-11-typescript-tips',
      url: 'https://techblog.com/posts/typescript-tips',
      mentions: [{ userId: 'user_102', username: 'devMike' } as CommentUserMentionInfo],
      hashtags: [{ tag: 'typescript' } as CommentUserHashTagInfo],
      createdAt: new Date().toISOString()
    }
  ];
  const isLive: boolean = true;
  const doSpamCheck: boolean = true;
  const sendEmails: boolean = false;
  const populateNotifications: boolean = true;
  const result: Array<SaveComment200Response> = await saveCommentsBulk(
    tenantId,
    createCommentParams,
    isLive,
    doSpamCheck,
    sendEmails,
    populateNotifications
  );
  console.log(result);
})();

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_981c';
const commentId: string = 'cmt-2048';
const broadcastId: string = 'broadcast-nyc-2025-11-22';
const commentTextUpdateRequest: CommentTextUpdateRequest = {
  text: 'Thanks for the update — I think @maria raises a good point. See #product-roadmap',
  mentions: [{ userId: 'user_maria', displayName: 'María López' }],
  hashtags: [{ tag: 'product-roadmap' }]
};
const editKey: string = 'editkey_7f3a';
const sso: string = 'sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
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

(async () => {
  const tenantId: string = 'tenant_9c2f7b';
  const id: string = 'comment_6a1b2c3d';
  const unBlockFromCommentParams: UnBlockFromCommentParams = {
    reason: 'User appealed; evidence reviewed and ban lifted',
    liftedByAdminId: 'admin_42',
    effectiveAt: new Date().toISOString()
  };
  const userId: string = 'user_1024';
  const anonUserId: string = 'anon_7f9e';
  const response: UnBlockCommentPublic200Response = await unBlockUserFromComment(tenantId, id, unBlockFromCommentParams, userId, anonUserId);
  console.log(response);
})();

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 = 'fastcomments_tenant_001';
const commentId: string = 'comment_55f3a2';
const userId: string = 'user_7890';
const anonUserId: string = 'anon_1a2b3c';
const result: FlagComment200Response = await unFlagComment(tenantId, commentId, userId, anonUserId);

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 = 'tenant_acme_82';
const commentId: string = 'f47ac10b-58cc-4372-a567-0e02b2c3d479';
const broadcastId: string = 'live-event-2025-11-22';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyX2lkIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const resultWithSso: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId, ssoToken);
const resultWithoutSso: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId);

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 = 'tenant_84a2c1';
const commentId: string = 'cmt-9f2b6d7a';
const broadcastId: string = 'live-20251122-nyc';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjoidXNlcjEyMyIsImlhdCI6MTY5MDUwMDAwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const responseWithSso: PinComment200Response = await unPinComment(tenantId, commentId, broadcastId, ssoToken);
const responseWithoutSso: PinComment200Response = await unPinComment(tenantId, commentId, broadcastId);

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_7b6f3a2c";
const id: string = "cmt_5f4e3a2b1d";
const updatableCommentParams: UpdatableCommentParams = {
  content: "I've updated my comment to add more context and fix a typo.",
  authorName: "Jordan Lee",
  meta: { editedBy: "moderator_12", tags: ["clarified"] },
  isVisible: true
};
const contextUserId: string = "user_98c3b";
const doSpamCheck: boolean = true;
const isLive: boolean = true;
const result: FlagCommentPublic200Response = await updateComment(tenantId, id, 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_news_42';
const commentId: string = 'cmt_5f8b9a2e';
const urlId: string = '/news/2025/11/22/election-results';
const broadcastId: string = 'brd_7f4a3';
const voteBodyParams: VoteBodyParams = { direction: 'up', weight: 1, reason: 'Helpful and on-topic' };
const sessionId: string = 'sess-9b8a7c6d1234';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.signedPayload';
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_7f3c9b2a9e1";
const addDomainConfigParams: AddDomainConfigParams = {
  domain: "comments.production.example.com",
  enableHttps: true,
  allowedOrigins: ["https://example.com", "https://dashboard.example.com"],
  cname: undefined, // optional parameter explicitly omitted
};
const result: AddDomainConfig200Response = await addDomainConfig(tenantId, addDomainConfigParams);

deleteDomainConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
domain	string	Yes

Response

Returns: DeleteDomainConfig200Response

Example

deleteDomainConfig Example

Copy

const tenantId: string | undefined = 'org-4f1a2b';
const domain: string = 'comments.acme-corp.com';
const result: DeleteDomainConfig200Response = await deleteDomainConfig(tenantId!, domain);

getDomainConfig

Parameters

Name	Type	Required	Description
tenantId	string	Yes
domain	string	Yes

Response

Returns: GetDomainConfig200Response

Example

getDomainConfig Example

Copy

const region: string | undefined = 'eu';
const tenantId: string = region ? `acme-tenant-82a3f-${region}` : 'acme-tenant-82a3f';
const domain: string = 'comments.acme-corp.com';
const previewMode: boolean | undefined = true;
const response: GetDomainConfig200Response = await getDomainConfig(tenantId, domain);

getDomainConfigs

Parameters

Name	Type	Required	Description
tenantId	string	Yes

Response

Returns: GetDomainConfigs200Response

Example

getDomainConfigs Example

Copy

const tenantId: string = 'acme-marketing-1a2b';
const includeInactive: boolean | undefined = undefined; // optional parameter demonstration
const options: { includeInactive?: boolean } = includeInactive === undefined ? {} : { includeInactive };
const response: GetDomainConfigs200Response = await getDomainConfigs(tenantId);
/* Optional parameters can be supplied as a second argument when available, e.g.:
   await getDomainConfigs(tenantId, { includeInactive: true }) */

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_4f2b1a9e-6c3d-4e5f-b1a2-abcdef123456";
const domainToUpdate: string = "comments.acme-products.com";
const patchDomainConfigParams: PatchDomainConfigParams = {
  primary: true,
  enableSsl: true,
  sslCertificateId: "ssl_cert_72f4b1",
  allowedOrigins: ["https://www.acme.com", "https://shop.acme.com"],
  forceHttpsRedirect: undefined
};
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 = 'acme-corp';
const domainToUpdate: string = 'comments.acme.com';
const updateDomainConfigParams: UpdateDomainConfigParams = {
  enableSsl: true,
  certificateProvider: 'letsencrypt',
  redirectHttpToHttps: true, // optional parameter demonstrated
  customCssUrl: 'https://cdn.acme.com/widgets/comments.css',
  moderationMode: 'pre-moderation',
  allowedOrigins: ['https://www.acme.com', 'https://blog.acme.com']
};
const updatedConfig: GetDomainConfig200Response = await putDomainConfig(tenantId, domainToUpdate, updateDomainConfigParams);

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_8a1f4';
const maybeUrlId: string | undefined = 'articles/2025/product-launch';
const urlId: string = maybeUrlId!;
const userIdWS: string = 'ws_user_4521';
const startTime: number = Date.now() - 1000 * 60 * 60 * 24; // 24 hours ago
const endTime: number = Date.now();
const result: GetEventLog200Response = await getEventLog(tenantId, urlId, userIdWS, startTime, endTime);

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 = 'acme_media_tenant_001';
const urlId: string = 'article-2025-11-22-fiber-upgrade';
const userIdWS: string = 'ws_user_78321';
const startTime: number = Date.now() - 1000 * 60 * 60 * 24; // 24 hours ago
const endTime: number = Date.now();
// Optional parameters example (not required by getGlobalEventLog)
const options: { includeMetadata?: boolean; maxEntries?: number } = { includeMetadata: true };
const result: GetEventLog200Response = await getGlobalEventLog(tenantId, urlId, userIdWS, startTime, endTime);
console.log(result);

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_9f2b1c';
const createFeedPostParams: CreateFeedPostParams = ({
  title: 'Feature X US Launch',
  body: 'Feature X is now available to all US customers. See rollout details and known issues below.',
  authorId: 'user_8421',
  tags: ['launch', 'feature-x', 'us'],
  media: [
    {
      type: 'image',
      assets: [{ url: 'https://cdn.example.com/featurex/hero.png', mimeType: 'image/png', width: 1200, height: 628 }]
    }
  ],
  links: [{ url: 'https://status.example.com/feature-x', title: 'Live Status' }]
} as unknown) as CreateFeedPostParams;
const broadcastId: string = 'broadcast_2025_11_22';
const isLive: boolean = false;
const doSpamCheck: boolean = true;
const skipDupCheck: boolean = false;
const result: 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 = 'tenant_acme_corp_001';
const createFeedPostParams: CreateFeedPostParams = {
  title: 'Introducing the new inline editor',
  body: 'Today we launched an editor that supports markdown, drag-and-drop images, and live preview.',
  authorId: 'user_4521',
  isPublished: true,
  tags: ['product','launch','editor'],
  media: [
    {
      type: 'image',
      assets: [
        { url: 'https://cdn.acme.com/images/editor-preview.png', mimeType: 'image/png', width: 1200, height: 800 }
      ]
    }
  ],
  links: [{ url: 'https://acme.com/blog/editor-release', title: 'Read the full release notes' }]
};
const broadcastId: string = 'broadcast_weekly_2025_11';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example_signature';
const response: 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_acme_2025';
const postId: string = 'post_9f8a7b6c';
const broadcastId: string = 'broadcast_us_east_01';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakeSignature';
const result: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId, broadcastId, sso);

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_acme_01';
const afterId: string | undefined = 'post_20251120_001';
const tags: string[] = ['product-update', 'security'];
const result: GetFeedPosts200Response = await getFeedPosts(tenantId, afterId, undefined, tags);
console.log(result);

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 = "tenant_4f2a9b6c";
const afterId: string = "post_20251120_8b7c";
const limit: number = 25;
const tags: Array<string> = ["technology", "product-release"];
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakepayload.signature";
const isCrawler: boolean = false;
const includeUserInfo: boolean = 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 = 'org-8421';
const postIds: string[] = [
  'c9a1e3f2-7b6d-4a11-9c2f-000000000001',
  'd4b2c3a5-8e7f-4b22-9d3e-000000000002'
];
const statsWithoutSso: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds);
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI0NTY3IiwiaWF0IjoxNjAwMDAwMDB9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const statsWithSso: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds, ssoToken);

getUserReactsPublic

Parameters

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

Response

Returns: GetUserReactsPublic200Response

Example

getUserReactsPublic Example

Copy

const tenantId: string = 'tenant_8a9f3c9b';
const postIds: string[] = ['post_4f2a1b6c', 'post_77b8c3d2'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1Njc4OSIsIm5hbWUiOiJKb2huIERvZSJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const response: GetUserReactsPublic200Response = await getUserReactsPublic(tenantId, postIds, sso);
console.log(response);

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 = 'acme-corp-tenant-47';
const postId: string = 'post_8f3a9b2c';
const reactBodyParams: ReactBodyParams = { reaction: 'like', userId: 'editor_42', metadata: { locale: 'en-US' } };
const isUndo: boolean = false;
const broadcastId: string = 'broadcast_20251122_01';
const sso: string = 'sso_eyJ1c2VyIjoiZWRpdG9yXzQyIn0';
const result: ReactFeedPostPublic200Response = await reactFeedPostPublic(tenantId, postId, reactBodyParams, 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 = 'acme-enterprises-42';
const id: string = 'feedpost_20251122_001';
const feedPost: FeedPost = {
  title: 'Product roadmap update',
  content: 'Updated roadmap including new moderation and analytics features.',
  authorName: 'Acme Product Team',
  isPublished: false,
  scheduledAt: '2025-12-01T09:00:00Z', // optional scheduling parameter
  media: [
    {
      type: 'image',
      url: 'https://assets.acme.com/images/roadmap.png',
      assets: [{ resolution: '1024x768', url: 'https://assets.acme.com/images/roadmap-1024.png' }]
    }
  ],
  links: [{ title: 'Full Roadmap', url: 'https://acme.com/roadmap' }],
  tags: ['roadmap', 'release', 'moderation']
};
const result: 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_acme_corp_01";
const postId: string = "post_2025-11-22-001";
const updateFeedPostParams: UpdateFeedPostParams = {
  title: "Service Window: Brief Maintenance",
  content: "We will perform a brief maintenance window on 2025-11-23 at 02:00 UTC. Expected downtime ~5 minutes.",
  media: [{ id: "m_1001", type: "image", assets: [{ url: "https://cdn.acme.com/images/maintenance-banner.jpg", width: 1200, height: 300 }] }],
  links: [{ url: "https://status.acme.com/2025-11-23", title: "Detailed status" }],
  isPublished: true
};
const broadcastId: string = "broadcast_9f8b7c6d";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload.signature";
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

async function demoFlagComment(): Promise<void> {
  const tenantId: string = 'tenant_9a7c3f2b';
  const commentId: string = 'cmt_5d8e12a4';
  const isFlagged: boolean = true;
  const sso: string | undefined = 'sso_tok_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
  const result: FlagCommentPublic200Response = await flagCommentPublic(tenantId, commentId, isFlagged, sso);
  console.log(result);
}
demoFlagComment();

addPage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createAPIPageData	CreateAPIPageData	Yes

Response

Returns: AddPageAPIResponse

Example

addPage Example

Copy

(async () => {
  const tenantId: string = "tenant_8f3b2a9c-prod";
  const createAPIPageData: CreateAPIPageData = {
    url: "https://acme.blog/products/fastsync-2",
    title: "Introducing FastSync 2.0",
    slug: "fastsync-2-0",
    tags: ["releases", "sync", "performance"],
    isPublic: true,
    language: "en-US",
    canonicalUrl: "https://acme.com/products/fastsync-2", // optional
    metadata: { authorId: "user_42", summary: "Faster sync across devices." } // optional
  };
  const result: AddPageAPIResponse = await addPage(tenantId, createAPIPageData);
  console.log((result as any).page as APIPage);
})();

deletePage

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: DeletePageAPIResponse

Example

deletePage Example

Copy

const tenantId: string = 'acme-tenant-8421';
const id: string = 'page-home-2024-11-22';
const initiatedBy: string | undefined = 'ops@acme-corp.com'; // optional metadata
const result: 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-enterprises-tenant-42";
const urlId: string = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
const includeArchived: boolean | undefined = undefined; // optional flag example (not required by getPageByURLId)
const pageResponse: GetPageByURLIdAPIResponse = await getPageByURLId(tenantId, urlId);
const page: APIPage | undefined = (pageResponse as any)?.page;
const pageTitle: string | undefined = (page as any)?.title;

getPages

Parameters

Name	Type	Required	Description
tenantId	string	Yes

Response

Returns: GetPagesAPIResponse

Example

getPages Example

Copy

const tenantId: string = 'acme-inc-78f9';
const includeDrafts: boolean | undefined = undefined;
const pageSize: number | undefined = 25;
const pagesResponse: GetPagesAPIResponse = await getPages(tenantId);
const pages: APIPage[] | undefined = (pagesResponse as any).pages;
const firstPageTitle: string | undefined = pages?.[0]?.title as string | undefined;

patchPage

Parameters

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

Response

Returns: PatchPageAPIResponse

Example

patchPage Example

Copy

const tenantId: string = 'acme-tenant-01';
const pageId: string = 'page_4f7a2b9d';
const updateData: UpdateAPIPageData = {
  title: 'About Acme Corporation',
  slug: '/about',
  isPublished: true,
  tags: ['company', 'about'], // optional array of tags
  metadata: { description: 'Company history and mission statement.' }, // optional nested object
  lastEditedBy: 'j.smith@acme.com' // optional auditor field
};
const response: PatchPageAPIResponse = await patchPage(tenantId, pageId, updateData);

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

(async () => {
  const tenantId: string = "tenant_8a3f9b2";
  const questionId: string | undefined = undefined;
  const questionIds: Array<string> = ["q-2024-001", "q-2024-002"];
  const urlId: string | undefined = "url_4f9c";
  const timeBucket: AggregateTimeBucket = ("monthly" as unknown) as AggregateTimeBucket;
  const startDate: Date = new Date("2025-01-01T00:00:00Z");
  const forceRecalculate: boolean = true;
  const result: AggregateQuestionResults200Response = await aggregateQuestionResults(
    tenantId,
    questionId,
    questionIds,
    urlId,
    timeBucket,
    startDate,
    forceRecalculate
  );
  console.log(result);
})();

bulkAggregateQuestionResults

Parameters

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

Response

Returns: BulkAggregateQuestionResults200Response

Example

bulkAggregateQuestionResults Example

Copy

(async () => {
  const tenantId: string = "tenant_prod_84b2";
  const bulkAggregateQuestionResultsRequest: BulkAggregateQuestionResultsRequest = {
    questionIds: ["q_9fa1b2", "q_3c4d5e"],
    startDate: "2025-10-01T00:00:00Z",
    endDate: "2025-10-31T23:59:59Z",
    groupBy: "question",
    timeBucket: "day"
  };
  const forceRecalculate: boolean = true;
  const result: BulkAggregateQuestionResults200Response = await bulkAggregateQuestionResults(tenantId, bulkAggregateQuestionResultsRequest, forceRecalculate);
  console.log(result);
})();

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 = 'acme-publisher-01';
const questionIds: string[] = ['q_7f3a2b', 'q_9b1c4d'];
const urlId: string = 'article-2025-11-22';
const startDate: Date = new Date('2025-01-01T00:00:00Z');
const forceRecalculate: boolean = true;
const minValue: number = 0;
const maxValue: number = 5;
const limit: number = 100;
const result: CombineCommentsWithQuestionResults200Response = await combineCommentsWithQuestionResults({
  tenantId,
  questionIds,
  urlId,
  startDate,
  forceRecalculate,
  minValue,
  maxValue,
  limit
});

addSSOUser

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createAPISSOUserData	CreateAPISSOUserData	Yes

Response

Returns: AddSSOUserAPIResponse

Example

addSSOUser Example

Copy

const tenantId: string = 'acme-corp-tenant-42';
const createData: CreateAPISSOUserData = {
  externalId: 'google-oauth2|112233445566778899',
  email: 'emma.jones@acme-corp.com',
  displayName: 'Emma Jones',
  roles: ['moderator'], // optional field included
  isAdmin: false,
  avatarUrl: 'https://cdn.acme-corp.com/avatars/emma.jpg',
  metadata: { department: 'product', locale: 'en-US' } // optional metadata
} as CreateAPISSOUserData;
const result: AddSSOUserAPIResponse = await addSSOUser(tenantId, createData);

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_84b2f1e';
const id: string = 'ssouser_5a9c3d2';
const deleteComments: boolean = true;
const commentDeleteMode: string = 'permanent';
const response: DeleteSSOUserAPIResponse = await deleteSSOUser(tenantId, id, deleteComments, commentDeleteMode);

getSSOUserByEmail

Parameters

Name	Type	Required	Description
tenantId	string	Yes
email	string	Yes

Response

Returns: GetSSOUserByEmailAPIResponse

Example

getSSOUserByEmail Example

Copy

const tenantId: string = 'tenant_9b7f2c';
const email: string = 'jane.doe@acme-corp.com';
const response: GetSSOUserByEmailAPIResponse = await getSSOUserByEmail(tenantId, email);
const user: APISSOUser | undefined = (response as unknown as { user?: APISSOUser }).user;
const emailVerified: boolean | undefined = user?.emailVerified;

getSSOUserById

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetSSOUserByIdAPIResponse

Example

getSSOUserById Example

Copy

const tenantId: string = 'acme-corp-tenant-9a8b';
const userId: string = 'user_73f2b6';
const sessionSegment: string | undefined = undefined; // optional segment appended when present
const effectiveId: string = sessionSegment ? `${userId}:${sessionSegment}` : userId;
const result: GetSSOUserByIdAPIResponse = await getSSOUserById(tenantId, effectiveId);

getSSOUsers

Parameters

Name	Type	Required	Description
tenantId	string	Yes
skip	number	No

Response

Returns: GetSSOUsers200Response

Example

getSSOUsers Example

Copy

const tenantId: string = 'tenant_7f8b3c4d-01';
const skip: number = 50;
const usersFirstPage: GetSSOUsers200Response = await getSSOUsers(tenantId);
const usersSecondPage: 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

const tenantId: string = 'tenant_acme_001';
const id: string = 'user_7842b';
const updateAPISSOUserData: UpdateAPISSOUserData = {
  email: 'jane.doe@acmecorp.com',
  displayName: 'Jane Doe',
  externalId: 'acme|jdoe',
  roles: ['editor'],
  metadata: { team: 'Growth' }
};
const updateComments: boolean = true;
const result: PatchSSOUserAPIResponse = await patchSSOUser(tenantId, id, updateAPISSOUserData, 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 = 'acme-tenant-9b3f2a';
const id: string = 'sso-user-7f1c2d';
const updateData: UpdateAPISSOUserData = {
  externalId: 'auth0|6032b1a7',
  email: 'jane.doe@acme.com',
  displayName: 'Jane Doe',
  avatarUrl: 'https://cdn.acme.com/avatars/jane.jpg',
  roles: ['moderator'],
  metadata: { team: 'Platform', location: 'NYC' }
};
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

const tenantId: string = 'acme-corp-tenant-4f3e2b1a';
const createData: CreateAPIUserSubscriptionData = {
  userId: 'user_987654',
  planId: 'pro_monthly',
  paymentMethodId: 'pm_1Hh2K4Lx',
  startDate: '2025-12-01T00:00:00Z',
  trialDays: 14,
  metadata: { campaign: 'black_friday_2025' }
} as CreateAPIUserSubscriptionData;
const result: CreateSubscriptionAPIResponse = await createSubscription(tenantId, createData);

deleteSubscription

Parameters

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

Response

Returns: DeleteSubscriptionAPIResponse

Example

deleteSubscription Example

Copy

(async () => {
  const tenantId: string = "acme-enterprises-123";
  const subscriptionId: string = "sub_8f2b4c9d";
  const userId: string = "user_42b7a";
  const responseWithUser: DeleteSubscriptionAPIResponse = await deleteSubscription(tenantId, subscriptionId, userId);
  const responseWithoutUser: DeleteSubscriptionAPIResponse = await deleteSubscription(tenantId, subscriptionId);
})();

getSubscriptions

Parameters

Name	Type	Required	Description
tenantId	string	Yes
userId	string	No

Response

Returns: GetSubscriptionsAPIResponse

Example

getSubscriptions Example

Copy

(async () => {
  const tenantId: string = "tenant_acme_01";
  const userId: string = "user_jdoe_42";
  const allSubscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId);
  const userSubscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId, userId);
  console.log(allSubscriptions, userSubscriptions);
})();

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 = "fc-tenant-84b9f3c2";
const imageData: Uint8Array = new Uint8Array([255,216,255,224,0,16,74,70,73,70]);
const file: Blob = new Blob([imageData], { type: "image/jpeg" });
const sizePreset: SizePreset = { name: "medium", maxWidth: 1024, maxHeight: 768 };
const urlId: string = "products/blue-widget-2025/hero-image";
const uploadResult: UploadImageResponse = await uploadImage(tenantId, file, sizePreset, urlId);
const uploadResultMinimal: UploadImageResponse = await uploadImage(tenantId, file);

getUserBadgeProgressById

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetUserBadgeProgressById200Response

Example

getUserBadgeProgressById Example

Copy

const tenantId: string = "acme-enterprise-84a1";
const id: string = "user-9f2c1a7b";
const fieldsToInclude: string[] | undefined = ["progress", "milestones"]; // optional parameters example
const badgeProgress: GetUserBadgeProgressById200Response = await getUserBadgeProgressById(tenantId, id);

getUserBadgeProgressByUserId

Parameters

Name	Type	Required	Description
tenantId	string	Yes
userId	string	Yes

Response

Returns: GetUserBadgeProgressById200Response

Example

getUserBadgeProgressByUserId Example

Copy

const tenantId: string = 'acme-corp-2025';
const userId: string = 'user_72a9e4b8';
const result: GetUserBadgeProgressById200Response = await getUserBadgeProgressByUserId(tenantId, userId);
const badgeProgress: UserBadgeProgress | undefined = (result as any)?.badgeProgress;
const apiStatus: APIStatus | undefined = (result as any)?.status;
const includeDetails?: boolean = true;

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 = '3fa85f64-5717-4562-b3fc-2c963f66afa6';
const userId: string = 'user-8d7b2a9c';
const limit: number = 25;
const skip: number = 0;
const badgeProgress: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId, userId, limit, skip);
const badgeProgressMinimal: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId);

createUserBadge

Parameters

Name	Type	Required	Description
tenantId	string	Yes
createUserBadgeParams	CreateUserBadgeParams	Yes

Response

Returns: CreateUserBadge200Response

Example

createUserBadge Example

Copy

const tenantId: string = "fastcomments_tenant_01";
const createUserBadgeParams: CreateUserBadgeParams = {
  name: "Community Helper",
  description: "Awarded for consistently helpful and constructive replies",
  iconUrl: "https://assets.examplecdn.com/badges/community-helper.svg",
  // optional parameters
  criteria: { type: "comment_count", threshold: 100 },
  active: true,
  customConfig: { color: "#1e90ff", highlight: true }
};
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

(async () => {
  const tenantId: string = 'acme-inc-7a1b2c';
  const optionalBadgeId: string | undefined = 'badge_9f3e1'; // could be undefined to use fallback
  const id: string = optionalBadgeId ?? 'badge_default_0001';
  const result: UpdateUserBadge200Response = await deleteUserBadge(tenantId, id);
  console.log(result);
})();

getUserBadge

Parameters

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Response

Returns: GetUserBadge200Response

Example

getUserBadge Example

Copy

const tenantId: string = 'acmecorp-prod-01';
const userId: string = 'usr_78a9b2c4';
const result: GetUserBadge200Response = await getUserBadge(tenantId, userId);
const options: { includeDetails?: boolean } = { includeDetails: true };
const badgeName: string | undefined = (result as any)?.userBadge?.name;
if (options.includeDetails) {
  const badgeDescription: string | undefined = (result as any)?.userBadge?.description;
  void badgeDescription;
}

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

const tenantId: string = 'tenant_9b3a2c';
const userId: string = 'user_5821';
const badgeId: string | undefined = undefined;
const type: number | undefined = 2;
const displayedOnComments: boolean | undefined = true;
const limit: number | undefined = 25;
const skip: number | undefined = 0;
const badges: GetUserBadges200Response = await getUserBadges(tenantId, userId, badgeId, type, displayedOnComments, limit, skip);

updateUserBadge

Parameters

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

Response

Returns: UpdateUserBadge200Response

Example

updateUserBadge Example

Copy

const tenantId: string = "tenant_9k2h7a";
const id: string = "badge_01F8ZC7";
const updateUserBadgeParams: UpdateUserBadgeParams = {
  name: "Helpful Contributor",
  description: "Awarded for 100 helpful comments",
  iconUrl: "https://cdn.fastcomments.com/badges/helpful.png",
  enabled: true,
  expiresAt: "2026-12-31T23:59:59Z" // optional parameter
} as UpdateUserBadgeParams;
const result: 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 = 'fastcomments-tenant-42';
const ssoToken: string = 'sso:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example';
const notificationsWithoutSSO: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId);
const notificationsWithSSO: 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

const tenantId: string = 'tenant_7f4b2a1c';
const pageSize: number = 25;
const afterId: string | undefined = undefined;
const includeContext: boolean = true;
const afterCreatedAt: number | undefined = Date.now() - 7 * 24 * 60 * 60 * 1000;
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const noDm: boolean | undefined = undefined;
const includeTranslations: boolean = true;
const sso: string | undefined = 'sso_jwt_eyJhbGci';
const response: GetUserNotifications200Response = await getUserNotifications(
  tenantId,
  pageSize,
  afterId,
  includeContext,
  afterCreatedAt,
  unreadOnly,
  dmOnly,
  noDm,
  includeTranslations,
  sso
);

resetUserNotificationCount

Parameters

Name	Type	Required	Description
tenantId	string	Yes
sso	string	No

Response

Returns: ResetUserNotifications200Response

Example

resetUserNotificationCount Example

Copy

const tenantId: string = 'tenant_acme_9b3a2d';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyQGFjbWUuY29tIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const resetResponse: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId);
const resetResponseWithSso: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId, ssoToken);

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_8f2d3c';
const afterId: string | undefined = 'notif_5b7a1e';
const afterCreatedAt: number | undefined = Date.now() - 2 * 60 * 60 * 1000;
const unreadOnly: boolean | undefined = true;
const dmOnly: boolean | undefined = false;
const noDm: boolean | undefined = undefined;
const sso: string | undefined = 'sso_user_24a9';
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_9f1b2c";
const notificationId: string = "notification_1024";
const optedInOrOut: UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum = UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum.OptedIn;
const commentId: string = "cmt_20251122_abcd";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload.signature";
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_9f4c2b1a';
const urlId: string = 'article-2025-11-22-fastcomments';
const url: string = 'https://blog.example.com/2025/11/fastcomments-tutorial';
const pageTitle: string = 'FastComments Integration Guide';
const subscribedOrUnsubscribed: UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum = UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum.Subscribed;
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakeSignature';
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 = "acme-tenant-42";
const notificationId: string = "notif-2025-11-22-7a3b";
const newStatus: UpdateUserNotificationStatusNewStatusEnum = UpdateUserNotificationStatusNewStatusEnum.Read;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampleSignature";
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationStatus(tenantId, notificationId, newStatus, sso);

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-corp-tenant-1';
const urlIdWS: string = 'wss://realtime.fastcomments.com/ws/site-acme';
const optionalExtraUserId: string | undefined = 'user_789'; // optional
const userIds: string = ['user_123', 'user_456', ...(optionalExtraUserId ? [optionalExtraUserId] : [])].join(',');
const presenceStatuses: GetUserPresenceStatuses200Response = await getUserPresenceStatuses(tenantId, urlIdWS, userIds);
presenceStatuses;

searchUsers

Parameters

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

Response

Returns: SearchUsers200Response

Example

searchUsers Example

Copy

const tenantId: string = "tenant_acme_corp";
const urlId: string = "news/2025/11/22/site-launch";
const usernameStartsWith: string = "jo";
const mentionGroupIds: Array<string> = ["senior-editors", "community-moderators"];
const sso: string = "sso_session_9f8e7d6c5b4a3";
const result: SearchUsers200Response = await searchUsers(tenantId, urlId, usernameStartsWith, mentionGroupIds, sso);

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.

Getting Started

API Reference

Documentation

Usage

Aggregate

Audit Logs

Block From Comment

Check Blocked Comments

Comments

Domain Configs

Event Log

Feed Posts

Flag Comment

Pages

Question Results Aggregation

SSO Users

Subscriptions

Upload Image

User Badge Progress

User Badges

User Notifications

User Presence Status

User Search

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

TypeScript Support

aggregate

Parameters

Response

Example

getAuditLogs

Parameters

Response

Example

blockFromCommentPublic

Parameters

Response

Example

unBlockCommentPublic

Parameters

Response

Example

checkedCommentsForBlocked

Parameters

Response

Example

blockUserFromComment

Parameters

Response

Example

createCommentPublic