featurebase-node 0.0.2

package/src/resources/help-center/articles.ts

@@ -0,0 +1,1231 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ArticlesAPI from './articles';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Help centers allow organizations to create and manage knowledge bases with articles and collections. Currently, Featurebase supports one help center per organization.
+ */
+export class Articles extends APIResource {
+  /**
+   * Creates a new article in your organization's help center.
+   *
+   * ### Request Body
+   *
+   * Required attributes:
+   *
+   * - `title` - The title of the article
+   *
+   * Optional attributes:
+   *
+   * - `description` - A brief description of the article
+   * - `body` - The HTML content of the article (supports external image URLs and
+   *   base64 data URIs)
+   * - `formatter` - Content formatter: "default" or "ai" (AI converts markdown/html
+   *   to Featurebase format)
+   * - `parentId` - The ID of the parent collection
+   * - `icon` - Icon object with type and value
+   * - `state` - "live" or "draft" (defaults to "draft")
+   * - `translations` - Dictionary of translations keyed by locale
+   *
+   * ### Response
+   *
+   * Returns the created article object with:
+   *
+   * - `id` - Unique identifier
+   * - `title` - Article title
+   * - `description` - Article description
+   * - `body` - Article content (HTML)
+   * - `slug` - URL slug
+   * - `icon` - Article icon (emoji or custom)
+   * - `parentId` - Parent collection ID
+   * - `helpCenterId` - ID of the help center this article belongs to
+   * - `organization` - Organization ID
+   * - `state` - Article state (live or draft)
+   * - `author` - Author information (name, authorId, avatarUrl)
+   * - `translations` - Translations for different locales
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   *
+   * @example
+   * ```ts
+   * const article = await client.helpCenter.articles.create({
+   *   title: 'Getting Started Guide',
+   * });
+   * ```
+   */
+  create(params: ArticleCreateParams, options?: RequestOptions): APIPromise<Article> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/help_center/articles', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Retrieves a specific article by its unique identifier.
+   *
+   * Returns the article object if found in your organization's help center.
+   *
+   * ### Query Parameters
+   *
+   * - `state` - Article state to retrieve: "live" or "draft" (default "live")
+   *
+   * ### Response
+   *
+   * Returns an article object with:
+   *
+   * - `id` - Unique identifier
+   * - `title` - Article title
+   * - `description` - Article description
+   * - `body` - Article content (HTML)
+   * - `slug` - URL slug
+   * - `icon` - Article icon (emoji or custom)
+   * - `parentId` - Parent collection ID
+   * - `helpCenterId` - ID of the help center this article belongs to
+   * - `organization` - Organization ID
+   * - `state` - Article state (live or draft)
+   * - `defaultLocale` - Default locale for content
+   * - `locale` - Current locale
+   * - `availableLocales` - Array of available locales
+   * - `publishedLocales` - Array of locales where article is published
+   * - `featurebaseUrl` - Featurebase URL for the article
+   * - `externalUrl` - External URL if custom domain is configured
+   * - `author` - Author information (name, authorId, avatarUrl)
+   * - `order` - Display order
+   * - `isPublished` - Whether the article is published
+   * - `isDraftDiffersFromLive` - Whether draft differs from live version
+   * - `translations` - Translations for different locales
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   * - `liveUpdatedAt` - ISO 8601 timestamp when live version was last updated
+   *
+   * ### Errors
+   *
+   * - `404` - Article not found in your organization's help center
+   *
+   * @example
+   * ```ts
+   * const article = await client.helpCenter.articles.retrieve(
+   *   '1234567',
+   * );
+   * ```
+   */
+  retrieve(
+    id: string,
+    params: ArticleRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Article> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.get(path`/v2/help_center/articles/${id}`, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Updates an existing article. Only include the fields you wish to update.
+   *
+   * ### Path Parameters
+   *
+   * - `id` - The unique identifier of the article to update
+   *
+   * ### Request Body
+   *
+   * All fields are optional. Only provided fields will be updated:
+   *
+   * - `title` - The new title of the article
+   * - `description` - The new description of the article
+   * - `body` - The new HTML content of the article
+   * - `formatter` - Content formatter: "default" or "ai"
+   * - `icon` - Updated icon object for the article
+   * - `parentId` - New parent collection ID
+   * - `authorId` - ID of the new author (must be a member of the organization)
+   * - `state` - "live" or "draft" - if "live", publishes immediately
+   * - `translations` - Dictionary of updated translations keyed by locale
+   *
+   * ### Response
+   *
+   * Returns the updated article object with:
+   *
+   * - `id` - Unique identifier
+   * - `title` - Article title
+   * - `description` - Article description
+   * - `body` - Article content (HTML)
+   * - `slug` - URL slug
+   * - `icon` - Article icon (emoji or custom)
+   * - `parentId` - Parent collection ID
+   * - `helpCenterId` - ID of the help center this article belongs to
+   * - `organization` - Organization ID
+   * - `state` - Article state (live or draft)
+   * - `author` - Author information (name, authorId, avatarUrl)
+   * - `translations` - Translations for different locales
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   *
+   * ### Errors
+   *
+   * - `404` - Article not found in your organization's help center
+   *
+   * @example
+   * ```ts
+   * const article = await client.helpCenter.articles.update(
+   *   '1234567',
+   * );
+   * ```
+   */
+  update(id: string, params: ArticleUpdateParams, options?: RequestOptions): APIPromise<Article> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.patch(path`/v2/help_center/articles/${id}`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Returns a paginated list of articles within your organization's help center.
+   *
+   * Articles are the main content pieces that contain documentation, guides, and
+   * FAQs.
+   *
+   * ### Query Parameters
+   *
+   * - `limit` - Number of items to return (1-100, default 10)
+   * - `cursor` - Cursor for pagination
+   * - `state` - Filter by article state: "live", "draft", or "all" (default "live")
+   * - `parentId` - Filter by parent collection ID
+   *
+   * ### Response Format
+   *
+   * Returns a list object with:
+   *
+   * - `object` - Always "list"
+   * - `data` - Array of article objects
+   * - `nextCursor` - Cursor for next page (null if no more results)
+   *
+   * ### Article Object
+   *
+   * Each article includes:
+   *
+   * - `id` - Unique identifier
+   * - `title` - Article title
+   * - `description` - Article description
+   * - `body` - Article content (HTML)
+   * - `slug` - URL slug
+   * - `icon` - Article icon (emoji or custom)
+   * - `parentId` - Parent collection ID
+   * - `helpCenterId` - ID of the help center this article belongs to
+   * - `organization` - Organization ID
+   * - `state` - Article state (live or draft)
+   * - `defaultLocale` - Default locale for content
+   * - `locale` - Current locale
+   * - `availableLocales` - Array of available locales
+   * - `publishedLocales` - Array of locales where article is published
+   * - `featurebaseUrl` - Featurebase URL for the article
+   * - `externalUrl` - External URL if custom domain is configured
+   * - `author` - Author information (name, authorId, avatarUrl)
+   * - `order` - Display order
+   * - `isPublished` - Whether the article is published
+   * - `isDraftDiffersFromLive` - Whether draft differs from live version
+   * - `translations` - Translations for different locales
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   * - `liveUpdatedAt` - ISO 8601 timestamp when live version was last updated
+   *
+   * @example
+   * ```ts
+   * const articles = await client.helpCenter.articles.list();
+   * ```
+   */
+  list(
+    params: ArticleListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ArticleListResponse> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.get('/v2/help_center/articles', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Deletes an existing article.
+   *
+   * ### Path Parameters
+   *
+   * - `id` - The unique identifier of the article to delete
+   *
+   * ### Response
+   *
+   * Returns a deletion confirmation object:
+   *
+   * - `id` - The ID of the deleted article
+   * - `object` - Always "article"
+   * - `deleted` - Always true
+   *
+   * ### Errors
+   *
+   * - `404` - Article not found in your organization's help center
+   *
+   * @example
+   * ```ts
+   * const article = await client.helpCenter.articles.delete(
+   *   '1234567',
+   * );
+   * ```
+   */
+  delete(
+    id: string,
+    params: ArticleDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ArticleDeleteResponse> {
+    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+    return this._client.delete(path`/v2/help_center/articles/${id}`, {
+      ...options,
+      headers: buildHeaders([
+        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface Article {
+  /**
+   * Article unique identifier
+   */
+  id: string;
+
+  /**
+   * Available locales
+   */
+  availableLocales: Array<
+    | 'bn'
+    | 'bs'
+    | 'pt-BR'
+    | 'bg'
+    | 'ca'
+    | 'hr'
+    | 'cs'
+    | 'da'
+    | 'nl'
+    | 'en'
+    | 'et'
+    | 'fi'
+    | 'fr'
+    | 'de'
+    | 'el'
+    | 'hi'
+    | 'hu'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'lv'
+    | 'lt'
+    | 'ms'
+    | 'mn'
+    | 'nb'
+    | 'pl'
+    | 'pt'
+    | 'ro'
+    | 'ru'
+    | 'sr'
+    | 'zh-CN'
+    | 'sk'
+    | 'sl'
+    | 'es'
+    | 'sw'
+    | 'sv'
+    | 'th'
+    | 'zh-TW'
+    | 'tr'
+    | 'uk'
+    | 'vi'
+  >;
+
+  /**
+   * ISO 8601 timestamp when created
+   */
+  createdAt: string;
+
+  /**
+   * Help Center ID
+   */
+  helpCenterId: string;
+
+  /**
+   * Current locale
+   */
+  locale:
+    | 'bn'
+    | 'bs'
+    | 'pt-BR'
+    | 'bg'
+    | 'ca'
+    | 'hr'
+    | 'cs'
+    | 'da'
+    | 'nl'
+    | 'en'
+    | 'et'
+    | 'fi'
+    | 'fr'
+    | 'de'
+    | 'el'
+    | 'hi'
+    | 'hu'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'lv'
+    | 'lt'
+    | 'ms'
+    | 'mn'
+    | 'nb'
+    | 'pl'
+    | 'pt'
+    | 'ro'
+    | 'ru'
+    | 'sr'
+    | 'zh-CN'
+    | 'sk'
+    | 'sl'
+    | 'es'
+    | 'sw'
+    | 'sv'
+    | 'th'
+    | 'zh-TW'
+    | 'tr'
+    | 'uk'
+    | 'vi';
+
+  /**
+   * Object type identifier
+   */
+  object: 'article';
+
+  /**
+   * Organization ID
+   */
+  organization: string;
+
+  /**
+   * Article state
+   */
+  state: 'live' | 'draft';
+
+  /**
+   * ISO 8601 timestamp when last updated
+   */
+  updatedAt: string;
+
+  /**
+   * Article author
+   */
+  author?: ArticleAuthor;
+
+  /**
+   * Article body content (HTML)
+   */
+  body?: string;
+
+  /**
+   * Default locale
+   */
+  defaultLocale?:
+    | 'bn'
+    | 'bs'
+    | 'pt-BR'
+    | 'bg'
+    | 'ca'
+    | 'hr'
+    | 'cs'
+    | 'da'
+    | 'nl'
+    | 'en'
+    | 'et'
+    | 'fi'
+    | 'fr'
+    | 'de'
+    | 'el'
+    | 'hi'
+    | 'hu'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'lv'
+    | 'lt'
+    | 'ms'
+    | 'mn'
+    | 'nb'
+    | 'pl'
+    | 'pt'
+    | 'ro'
+    | 'ru'
+    | 'sr'
+    | 'zh-CN'
+    | 'sk'
+    | 'sl'
+    | 'es'
+    | 'sw'
+    | 'sv'
+    | 'th'
+    | 'zh-TW'
+    | 'tr'
+    | 'uk'
+    | 'vi';
+
+  /**
+   * Article description
+   */
+  description?: string;
+
+  /**
+   * External URL
+   */
+  externalUrl?: string;
+
+  /**
+   * Featurebase URL
+   */
+  featurebaseUrl?: string;
+
+  /**
+   * Article icon
+   */
+  icon?: Article.Icon | null;
+
+  /**
+   * Whether draft differs from live
+   */
+  isDraftDiffersFromLive?: boolean;
+
+  /**
+   * Whether the article is published
+   */
+  isPublished?: boolean;
+
+  /**
+   * ISO 8601 timestamp when live version was last updated
+   */
+  liveUpdatedAt?: string;
+
+  /**
+   * Display order
+   */
+  order?: number | null;
+
+  /**
+   * Parent collection ID
+   */
+  parentId?: string | null;
+
+  /**
+   * Path to article within help center hierarchy
+   */
+  path?: string;
+
+  /**
+   * Published locales
+   */
+  publishedLocales?: Array<
+    | 'bn'
+    | 'bs'
+    | 'pt-BR'
+    | 'bg'
+    | 'ca'
+    | 'hr'
+    | 'cs'
+    | 'da'
+    | 'nl'
+    | 'en'
+    | 'et'
+    | 'fi'
+    | 'fr'
+    | 'de'
+    | 'el'
+    | 'hi'
+    | 'hu'
+    | 'id'
+    | 'it'
+    | 'ja'
+    | 'ko'
+    | 'lv'
+    | 'lt'
+    | 'ms'
+    | 'mn'
+    | 'nb'
+    | 'pl'
+    | 'pt'
+    | 'ro'
+    | 'ru'
+    | 'sr'
+    | 'zh-CN'
+    | 'sk'
+    | 'sl'
+    | 'es'
+    | 'sw'
+    | 'sv'
+    | 'th'
+    | 'zh-TW'
+    | 'tr'
+    | 'uk'
+    | 'vi'
+  >;
+
+  /**
+   * URL slug
+   */
+  slug?: string;
+
+  /**
+   * Associated survey ID
+   */
+  surveyId?: string;
+
+  /**
+   * Article title
+   */
+  title?: string;
+
+  /**
+   * ISO 8601 timestamp when translation was created
+   */
+  translationCreatedAt?: string;
+
+  /**
+   * Translations by locale code
+   */
+  translations?: Article.Translations;
+
+  /**
+   * ISO 8601 timestamp when translation was last updated
+   */
+  translationUpdatedAt?: string;
+
+  /**
+   * Visibility settings
+   */
+  visibleBy?: Array<string>;
+}
+
+export namespace Article {
+  /**
+   * Article icon
+   */
+  export interface Icon {
+    /**
+     * Icon type
+     */
+    type: 'emoji' | 'custom';
+
+    /**
+     * Icon value (emoji or URL)
+     */
+    value: string;
+  }
+
+  /**
+   * Translations by locale code
+   */
+  export interface Translations {
+    id?: ArticlesAPI.ArticleTranslation;
+
+    bg?: ArticlesAPI.ArticleTranslation;
+
+    bn?: ArticlesAPI.ArticleTranslation;
+
+    bs?: ArticlesAPI.ArticleTranslation;
+
+    ca?: ArticlesAPI.ArticleTranslation;
+
+    cs?: ArticlesAPI.ArticleTranslation;
+
+    da?: ArticlesAPI.ArticleTranslation;
+
+    de?: ArticlesAPI.ArticleTranslation;
+
+    el?: ArticlesAPI.ArticleTranslation;
+
+    en?: ArticlesAPI.ArticleTranslation;
+
+    es?: ArticlesAPI.ArticleTranslation;
+
+    et?: ArticlesAPI.ArticleTranslation;
+
+    fi?: ArticlesAPI.ArticleTranslation;
+
+    fr?: ArticlesAPI.ArticleTranslation;
+
+    hi?: ArticlesAPI.ArticleTranslation;
+
+    hr?: ArticlesAPI.ArticleTranslation;
+
+    hu?: ArticlesAPI.ArticleTranslation;
+
+    it?: ArticlesAPI.ArticleTranslation;
+
+    ja?: ArticlesAPI.ArticleTranslation;
+
+    ko?: ArticlesAPI.ArticleTranslation;
+
+    lt?: ArticlesAPI.ArticleTranslation;
+
+    lv?: ArticlesAPI.ArticleTranslation;
+
+    mn?: ArticlesAPI.ArticleTranslation;
+
+    ms?: ArticlesAPI.ArticleTranslation;
+
+    nb?: ArticlesAPI.ArticleTranslation;
+
+    nl?: ArticlesAPI.ArticleTranslation;
+
+    pl?: ArticlesAPI.ArticleTranslation;
+
+    pt?: ArticlesAPI.ArticleTranslation;
+
+    'pt-BR'?: ArticlesAPI.ArticleTranslation;
+
+    ro?: ArticlesAPI.ArticleTranslation;
+
+    ru?: ArticlesAPI.ArticleTranslation;
+
+    sk?: ArticlesAPI.ArticleTranslation;
+
+    sl?: ArticlesAPI.ArticleTranslation;
+
+    sr?: ArticlesAPI.ArticleTranslation;
+
+    sv?: ArticlesAPI.ArticleTranslation;
+
+    sw?: ArticlesAPI.ArticleTranslation;
+
+    th?: ArticlesAPI.ArticleTranslation;
+
+    tr?: ArticlesAPI.ArticleTranslation;
+
+    uk?: ArticlesAPI.ArticleTranslation;
+
+    vi?: ArticlesAPI.ArticleTranslation;
+
+    'zh-CN'?: ArticlesAPI.ArticleTranslation;
+
+    'zh-TW'?: ArticlesAPI.ArticleTranslation;
+  }
+}
+
+/**
+ * Article author
+ */
+export interface ArticleAuthor {
+  /**
+   * Author user ID
+   */
+  authorId: string;
+
+  /**
+   * Author name
+   */
+  name: string;
+
+  /**
+   * Author avatar URL
+   */
+  avatarUrl?: string | null;
+}
+
+/**
+ * Icon object for the article
+ */
+export interface ArticleIconInputNova {
+  /**
+   * Type of icon (emoji or predefined only)
+   */
+  type: 'emoji' | 'predefined';
+
+  /**
+   * Icon value
+   */
+  value: string;
+}
+
+export interface ArticleTranslation {
+  /**
+   * Article author
+   */
+  author?: ArticleAuthor;
+
+  /**
+   * Article body content (HTML)
+   */
+  body?: string;
+
+  /**
+   * ISO 8601 timestamp when translation was created
+   */
+  createdAt?: string;
+
+  /**
+   * Article description
+   */
+  description?: string;
+
+  /**
+   * External URL
+   */
+  externalUrl?: string;
+
+  /**
+   * Featurebase URL
+   */
+  featurebaseUrl?: string;
+
+  /**
+   * URL slug
+   */
+  slug?: string;
+
+  /**
+   * Article title
+   */
+  title?: string;
+
+  /**
+   * ISO 8601 timestamp when translation was last updated
+   */
+  updatedAt?: string;
+}
+
+export interface ArticleTranslationInputNova {
+  /**
+   * Article body content in this locale (HTML or markdown)
+   */
+  body?: string;
+
+  /**
+   * Article description in this locale
+   */
+  description?: string;
+
+  /**
+   * Article title in this locale
+   */
+  title?: string;
+}
+
+export interface ArticleListResponse {
+  /**
+   * Array of article objects
+   */
+  data: Array<Article>;
+
+  /**
+   * Cursor for fetching the next page (cursor-based pagination)
+   */
+  nextCursor: string | null;
+
+  /**
+   * Object type identifier
+   */
+  object: 'list';
+}
+
+export interface ArticleDeleteResponse {
+  /**
+   * Unique identifier of the deleted article
+   */
+  id: string;
+
+  /**
+   * Indicates the resource was deleted
+   */
+  deleted: true;
+
+  /**
+   * Object type identifier
+   */
+  object: 'article';
+}
+
+export interface ArticleCreateParams {
+  /**
+   * Body param: The title of the article
+   */
+  title: string;
+
+  /**
+   * Body param: The HTML content of the article (supports external image URLs and
+   * base64 data URIs)
+   */
+  body?: string;
+
+  /**
+   * Body param: A brief description of the article
+   */
+  description?: string;
+
+  /**
+   * Body param: Content formatter - "ai" converts markdown/html to Featurebase
+   * format using AI
+   */
+  formatter?: 'default' | 'ai';
+
+  /**
+   * Body param: Icon object for the article
+   */
+  icon?: ArticleIconInputNova | null;
+
+  /**
+   * Body param: The ID of the parent collection
+   */
+  parentId?: string;
+
+  /**
+   * Body param: Article state - "live" publishes immediately, "draft" saves as draft
+   */
+  state?: 'live' | 'draft';
+
+  /**
+   * Body param: Dictionary of translations keyed by locale code
+   */
+  translations?: ArticleCreateParams.Translations;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: string;
+}
+
+export namespace ArticleCreateParams {
+  /**
+   * Dictionary of translations keyed by locale code
+   */
+  export interface Translations {
+    id?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bg?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bn?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bs?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ca?: ArticlesAPI.ArticleTranslationInputNova;
+
+    cs?: ArticlesAPI.ArticleTranslationInputNova;
+
+    da?: ArticlesAPI.ArticleTranslationInputNova;
+
+    de?: ArticlesAPI.ArticleTranslationInputNova;
+
+    el?: ArticlesAPI.ArticleTranslationInputNova;
+
+    en?: ArticlesAPI.ArticleTranslationInputNova;
+
+    es?: ArticlesAPI.ArticleTranslationInputNova;
+
+    et?: ArticlesAPI.ArticleTranslationInputNova;
+
+    fi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    fr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hu?: ArticlesAPI.ArticleTranslationInputNova;
+
+    it?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ja?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ko?: ArticlesAPI.ArticleTranslationInputNova;
+
+    lt?: ArticlesAPI.ArticleTranslationInputNova;
+
+    lv?: ArticlesAPI.ArticleTranslationInputNova;
+
+    mn?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ms?: ArticlesAPI.ArticleTranslationInputNova;
+
+    nb?: ArticlesAPI.ArticleTranslationInputNova;
+
+    nl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    pl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    pt?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'pt-BR'?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ro?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ru?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sk?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sv?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sw?: ArticlesAPI.ArticleTranslationInputNova;
+
+    th?: ArticlesAPI.ArticleTranslationInputNova;
+
+    tr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    uk?: ArticlesAPI.ArticleTranslationInputNova;
+
+    vi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'zh-CN'?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'zh-TW'?: ArticlesAPI.ArticleTranslationInputNova;
+  }
+}
+
+export interface ArticleRetrieveParams {
+  /**
+   * Query param: Article state to retrieve
+   */
+  state?: 'live' | 'draft';
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: string;
+}
+
+export interface ArticleUpdateParams {
+  /**
+   * Body param: ID of the new author (must be a member of the organization)
+   */
+  authorId?: string;
+
+  /**
+   * Body param: The new HTML content of the article
+   */
+  body?: string;
+
+  /**
+   * Body param: The new description of the article
+   */
+  description?: string;
+
+  /**
+   * Body param: Content formatter
+   */
+  formatter?: 'default' | 'ai';
+
+  /**
+   * Body param: Icon object for the article
+   */
+  icon?: ArticleIconInputNova | null;
+
+  /**
+   * Body param: New parent collection ID
+   */
+  parentId?: string | null;
+
+  /**
+   * Body param: Article state - if "live", publishes immediately
+   */
+  state?: 'live' | 'draft';
+
+  /**
+   * Body param: The new title of the article
+   */
+  title?: string;
+
+  /**
+   * Body param: Dictionary of updated translations keyed by locale code
+   */
+  translations?: ArticleUpdateParams.Translations;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: string;
+}
+
+export namespace ArticleUpdateParams {
+  /**
+   * Dictionary of updated translations keyed by locale code
+   */
+  export interface Translations {
+    id?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bg?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bn?: ArticlesAPI.ArticleTranslationInputNova;
+
+    bs?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ca?: ArticlesAPI.ArticleTranslationInputNova;
+
+    cs?: ArticlesAPI.ArticleTranslationInputNova;
+
+    da?: ArticlesAPI.ArticleTranslationInputNova;
+
+    de?: ArticlesAPI.ArticleTranslationInputNova;
+
+    el?: ArticlesAPI.ArticleTranslationInputNova;
+
+    en?: ArticlesAPI.ArticleTranslationInputNova;
+
+    es?: ArticlesAPI.ArticleTranslationInputNova;
+
+    et?: ArticlesAPI.ArticleTranslationInputNova;
+
+    fi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    fr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    hu?: ArticlesAPI.ArticleTranslationInputNova;
+
+    it?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ja?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ko?: ArticlesAPI.ArticleTranslationInputNova;
+
+    lt?: ArticlesAPI.ArticleTranslationInputNova;
+
+    lv?: ArticlesAPI.ArticleTranslationInputNova;
+
+    mn?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ms?: ArticlesAPI.ArticleTranslationInputNova;
+
+    nb?: ArticlesAPI.ArticleTranslationInputNova;
+
+    nl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    pl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    pt?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'pt-BR'?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ro?: ArticlesAPI.ArticleTranslationInputNova;
+
+    ru?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sk?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sl?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sv?: ArticlesAPI.ArticleTranslationInputNova;
+
+    sw?: ArticlesAPI.ArticleTranslationInputNova;
+
+    th?: ArticlesAPI.ArticleTranslationInputNova;
+
+    tr?: ArticlesAPI.ArticleTranslationInputNova;
+
+    uk?: ArticlesAPI.ArticleTranslationInputNova;
+
+    vi?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'zh-CN'?: ArticlesAPI.ArticleTranslationInputNova;
+
+    'zh-TW'?: ArticlesAPI.ArticleTranslationInputNova;
+  }
+}
+
+export interface ArticleListParams {
+  /**
+   * Query param: An opaque cursor for pagination. Use the nextCursor value from a
+   * previous response to fetch the next page of results.
+   */
+  cursor?: string;
+
+  /**
+   * Query param: Filter articles by help center ID. If omitted, returns articles
+   * across all help centers.
+   */
+  helpCenterId?: string;
+
+  /**
+   * Query param: A limit on the number of objects to be returned, between 1 and 100.
+   */
+  limit?: number;
+
+  /**
+   * Query param: Filter articles by parent collection ID
+   */
+  parentId?: string;
+
+  /**
+   * Query param: Filter articles by state. Use "all" to get both draft and live
+   * articles.
+   */
+  state?: 'live' | 'draft' | 'all';
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: string;
+}
+
+export interface ArticleDeleteParams {
+  /**
+   * API version for this request. Defaults to your organization's configured API
+   * version if not specified.
+   */
+  'Featurebase-Version'?: string;
+}
+
+export declare namespace Articles {
+  export {
+    type Article as Article,
+    type ArticleAuthor as ArticleAuthor,
+    type ArticleIconInputNova as ArticleIconInputNova,
+    type ArticleTranslation as ArticleTranslation,
+    type ArticleTranslationInputNova as ArticleTranslationInputNova,
+    type ArticleListResponse as ArticleListResponse,
+    type ArticleDeleteResponse as ArticleDeleteResponse,
+    type ArticleCreateParams as ArticleCreateParams,
+    type ArticleRetrieveParams as ArticleRetrieveParams,
+    type ArticleUpdateParams as ArticleUpdateParams,
+    type ArticleListParams as ArticleListParams,
+    type ArticleDeleteParams as ArticleDeleteParams,
+  };
+}