featurebase-node 0.15.0 → 0.15.2

package/src/resources/changelogs/changelogs.ts

@@ -55,6 +55,21 @@ export class Changelogs extends APIResource {
    *
    * Returns the created changelog object.
    *
+   * ### Batched translations (Orbit only)
+   *
+   * In API version 2026-08-19.orbit, optional `translations` accepts a locale-keyed
+   * dictionary of title, htmlContent or markdownContent, and featuredImage. Every
+   * listed locale (including an explicit top-level locale) must be enabled for the
+   * organization's changelogs, even if a translation already exists. New
+   * translations require title and nonempty content. Top-level title and content
+   * remain required on creation; supplied top-level content must be nonempty in
+   * nonempty batches. Top-level localized fields override the entry for `locale` (or
+   * the organization default); a top-level content format replaces the entry's
+   * content input. Nonempty batches save all drafts together and return the primary
+   * draft with draft availableLocales. Publication is separate. Omitted or empty
+   * dictionaries retain the existing flow. Completed uploads are not rolled back on
+   * failure.
+   *
    * @example
    * ```ts
    * const changelog = await client.changelogs.create({
@@ -93,8 +108,14 @@ export class Changelogs extends APIResource {
    * ### Localization
    *
    * The changelog content is returned in the organization's default locale. If the
-   * changelog doesn't exist in the default locale, the first available locale is
-   * used.
+   * changelog doesn't exist in the default locale, a 404 is returned.
+   *
+   * Orbit supports `allTranslations=true` to include a locale-keyed `translations`
+   * dictionary. With this option, `state=live|draft` selects the version for both
+   * the primary content and translations (default: live). Locales without that
+   * version are omitted; stored disabled locales remain readable. Without this
+   * option, the response is unchanged and prefers live content, falling back to
+   * draft.
    *
    * ### State
    *
@@ -112,9 +133,10 @@ export class Changelogs extends APIResource {
     id: string,
     params: ChangelogRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<Changelog> {
-    const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+  ): APIPromise<ChangelogRetrieveResponse> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
     return this._client.get(path`/v2/changelogs/${id}`, {
+      query,
       ...options,
       headers: buildHeaders([
         {
@@ -163,6 +185,34 @@ export class Changelogs extends APIResource {
    *
    * Returns the updated changelog object with all fields populated.
    *
+   * ### Batched translations (Orbit only)
+   *
+   * In API version 2026-08-19.orbit, optional `translations` accepts multiple
+   * locale-keyed draft updates. Each entry accepts title, htmlContent or
+   * markdownContent (not both), and featuredImage. New translations require title
+   * and nonempty content; existing translations preserve omitted fields. Supplied
+   * top-level content must also be nonempty for nonempty batches. Every listed
+   * locale must be enabled for the organization's changelogs, including existing
+   * translations and the primary-locale entry. Top-level localized fields target the
+   * organization default locale and override corresponding dictionary fields.
+   * HTML/Markdown are one content field: a top-level format replaces the entry's
+   * content input. Categories, segments and date remain top-level. The complete
+   * batch and global changes are saved together only after validation and content
+   * processing succeed. The response is the current organization default draft with
+   * draft availableLocales, not a translations dictionary. If that draft is absent,
+   * return the first edited locale in alphabetical order; if all entries are no-ops,
+   * return the first listed draft in alphabetical order. The response locale
+   * identifies the selected draft. Publication remains separate. Omitted or empty
+   * dictionaries retain existing behavior. An empty existing-locale entry is a
+   * no-op; an empty new-locale entry fails completeness validation. Completed
+   * uploads are not rolled back on failure. Existing legacy update/publication
+   * overwrite races are unchanged. Changing the organization default does not
+   * require creating its draft when updating other explicitly listed locales.
+   * Top-level localized fields still target the current default, and require title
+   * and content if creating that draft. Disabled locales return 400
+   * invalid_parameter, parameter locale: Locale "<locale>" is not enabled for this
+   * organization's changelogs.
+   *
    * ### Errors
    *
    * - `400` - Invalid changelog ID format or invalid input
@@ -711,6 +761,115 @@ export interface PublishUnpublishSuccess {
   state?: 'published' | 'scheduled' | 'unpublished';
 }
 
+export interface ChangelogRetrieveResponse extends Changelog {
+  translations?: { [key: string]: ChangelogRetrieveResponse.Translations };
+}
+
+export namespace ChangelogRetrieveResponse {
+  export interface Translations {
+    /**
+     * Content in HTML format
+     */
+    content: string;
+
+    /**
+     * Featured image URL
+     */
+    featuredImage: string | null;
+
+    /**
+     * Locale of the changelog
+     */
+    locale:
+      | 'ar'
+      | 'am'
+      | 'fa'
+      | 'ht'
+      | 'lo'
+      | 'my'
+      | 'pa'
+      | 'ps'
+      | 'so'
+      | 'tl'
+      | 'ur'
+      | 'he'
+      | 'ta'
+      | 'te'
+      | 'mr'
+      | 'gu'
+      | 'kn'
+      | 'ml'
+      | 'ha'
+      | 'jv'
+      | 'yo'
+      | 'ig'
+      | 'uz'
+      | 'ne'
+      | 'sd'
+      | 'az'
+      | 'si'
+      | 'km'
+      | 'kk'
+      | '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';
+
+    /**
+     * Content in markdown format
+     */
+    markdownContent: string | null;
+
+    /**
+     * State of the changelog
+     */
+    state: 'live' | 'draft';
+
+    /**
+     * Changelog title
+     */
+    title: string;
+  }
+}
+
 export interface ChangelogDeleteResponse {
   /**
    * Unique identifier of the deleted changelog
@@ -855,69 +1014,1861 @@ export interface ChangelogCreateParams {
   state?: 'draft' | 'live';
 
   /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
+   * Body param: Locale-keyed draft updates. Every listed locale must be enabled for
+   * the organization. New translations require title and nonempty htmlContent or
+   * markdownContent; existing translations preserve omitted fields. Do not combine
+   * content formats within an entry. For nonempty batches, supplied top-level
+   * content must also be nonempty. Top-level localized fields override the
+   * primary-locale entry (HTML/Markdown are one content field). An empty dictionary
+   * uses the existing flow; an empty existing-locale entry is a no-op. Nonempty
+   * batches are saved together and return the primary draft with draft
+   * availableLocales. On PATCH, if the current organization default draft is absent,
+   * return the first edited locale in alphabetical order; for an all-no-op batch,
+   * return the first listed draft in alphabetical order. The response locale
+   * identifies the selected draft. Publication is separate. Uploaded assets are not
+   * rolled back on failure.
    */
-  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
-}
+  translations?: ChangelogCreateParams.Translations;
 
-export interface ChangelogRetrieveParams {
   /**
-   * API version for this request. Defaults to your organization's configured API
-   * version if not specified.
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
    */
   'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface ChangelogUpdateParams {
+export namespace ChangelogCreateParams {
   /**
-   * Body param: An array of segment IDs that are allowed to view the changelog
+   * Locale-keyed draft updates. Every listed locale must be enabled for the
+   * organization. New translations require title and nonempty htmlContent or
+   * markdownContent; existing translations preserve omitted fields. Do not combine
+   * content formats within an entry. For nonempty batches, supplied top-level
+   * content must also be nonempty. Top-level localized fields override the
+   * primary-locale entry (HTML/Markdown are one content field). An empty dictionary
+   * uses the existing flow; an empty existing-locale entry is a no-op. Nonempty
+   * batches are saved together and return the primary draft with draft
+   * availableLocales. On PATCH, if the current organization default draft is absent,
+   * return the first edited locale in alphabetical order; for an all-no-op batch,
+   * return the first listed draft in alphabetical order. The response locale
+   * identifies the selected draft. Publication is separate. Uploaded assets are not
+   * rolled back on failure.
    */
-  allowedSegmentIds?: Array<string>;
+  export interface Translations {
+    id?: Translations.ID;
 
-  /**
-   * Body param: An array of category names to which the changelog belongs
-   */
-  categories?: Array<string>;
+    am?: Translations.Am;
 
-  /**
-   * Body param: The date of the changelog
-   */
-  date?: string | null;
+    ar?: Translations.Ar;
 
-  /**
-   * Body param: The URL of the featured image for the changelog. External URLs will
-   * be uploaded to our storage.
-   */
-  featuredImage?: string;
+    az?: Translations.Az;
 
-  /**
-   * Body param: HTML content of the changelog. Provide either htmlContent or
-   * markdownContent. Supports Featurebase custom blocks (callouts, multi-code,
-   * accordions, columns, file/image/video, iframes) — see the **Content Components**
-   * guide. External image URLs and base64 data URIs are uploaded to our storage
-   * automatically.
-   */
-  htmlContent?: string;
+    bg?: Translations.Bg;
 
-  /**
-   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
-   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
-   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
-   * htmlContent instead. See the **Content Components** guide.
-   */
-  markdownContent?: string;
+    bn?: Translations.Bn;
 
-  /**
-   * Body param: The title of the changelog
-   */
-  title?: string;
+    bs?: Translations.Bs;
 
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+    ca?: Translations.Ca;
+
+    cs?: Translations.Cs;
+
+    da?: Translations.Da;
+
+    de?: Translations.De;
+
+    el?: Translations.El;
+
+    en?: Translations.En;
+
+    es?: Translations.Es;
+
+    et?: Translations.Et;
+
+    fa?: Translations.Fa;
+
+    fi?: Translations.Fi;
+
+    fr?: Translations.Fr;
+
+    gu?: Translations.Gu;
+
+    ha?: Translations.Ha;
+
+    he?: Translations.He;
+
+    hi?: Translations.Hi;
+
+    hr?: Translations.Hr;
+
+    ht?: Translations.Ht;
+
+    hu?: Translations.Hu;
+
+    ig?: Translations.Ig;
+
+    it?: Translations.It;
+
+    ja?: Translations.Ja;
+
+    jv?: Translations.Jv;
+
+    kk?: Translations.Kk;
+
+    km?: Translations.Km;
+
+    kn?: Translations.Kn;
+
+    ko?: Translations.Ko;
+
+    lo?: Translations.Lo;
+
+    lt?: Translations.Lt;
+
+    lv?: Translations.Lv;
+
+    ml?: Translations.Ml;
+
+    mn?: Translations.Mn;
+
+    mr?: Translations.Mr;
+
+    ms?: Translations.Ms;
+
+    my?: Translations.My;
+
+    nb?: Translations.Nb;
+
+    ne?: Translations.Ne;
+
+    nl?: Translations.Nl;
+
+    pa?: Translations.Pa;
+
+    pl?: Translations.Pl;
+
+    ps?: Translations.Ps;
+
+    pt?: Translations.Pt;
+
+    'pt-BR'?: Translations.PtBr;
+
+    ro?: Translations.Ro;
+
+    ru?: Translations.Ru;
+
+    sd?: Translations.Sd;
+
+    si?: Translations.Si;
+
+    sk?: Translations.Sk;
+
+    sl?: Translations.Sl;
+
+    so?: Translations.So;
+
+    sr?: Translations.Sr;
+
+    sv?: Translations.Sv;
+
+    sw?: Translations.Sw;
+
+    ta?: Translations.Ta;
+
+    te?: Translations.Te;
+
+    th?: Translations.Th;
+
+    tl?: Translations.Tl;
+
+    tr?: Translations.Tr;
+
+    uk?: Translations.Uk;
+
+    ur?: Translations.Ur;
+
+    uz?: Translations.Uz;
+
+    vi?: Translations.Vi;
+
+    yo?: Translations.Yo;
+
+    'zh-CN'?: Translations.ZhCn;
+
+    'zh-TW'?: Translations.ZhTw;
+  }
+
+  export namespace Translations {
+    export interface ID {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Am {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ar {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Az {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bg {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bs {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ca {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Cs {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Da {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface De {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface El {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface En {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Es {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Et {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fa {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Gu {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ha {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface He {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ht {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hu {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ig {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface It {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ja {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Jv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Kk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Km {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Kn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ko {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lo {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lt {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ml {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Mn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Mr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ms {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface My {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Nb {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ne {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Nl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pa {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ps {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pt {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface PtBr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ro {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ru {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sd {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Si {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface So {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sw {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ta {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Te {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Th {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Tl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Tr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Uk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ur {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Uz {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Vi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Yo {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface ZhCn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface ZhTw {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+  }
+}
+
+export interface ChangelogRetrieveParams {
+  /**
+   * Query param: Include a locale-keyed translations dictionary. Omitted or false
+   * preserves the existing response.
+   */
+  allTranslations?: 'true' | 'false';
+
+  /**
+   * Query param: Version for allTranslations=true, defaulting to live. Ignored
+   * otherwise. Locales without this version are omitted.
+   */
+  state?: 'live' | 'draft';
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface ChangelogUpdateParams {
+  /**
+   * Body param: An array of segment IDs that are allowed to view the changelog
+   */
+  allowedSegmentIds?: Array<string>;
+
+  /**
+   * Body param: An array of category names to which the changelog belongs
+   */
+  categories?: Array<string>;
+
+  /**
+   * Body param: The date of the changelog
+   */
+  date?: string | null;
+
+  /**
+   * Body param: The URL of the featured image for the changelog. External URLs will
+   * be uploaded to our storage.
+   */
+  featuredImage?: string;
+
+  /**
+   * Body param: HTML content of the changelog. Provide either htmlContent or
+   * markdownContent. Supports Featurebase custom blocks (callouts, multi-code,
+   * accordions, columns, file/image/video, iframes) — see the **Content Components**
+   * guide. External image URLs and base64 data URIs are uploaded to our storage
+   * automatically.
+   */
+  htmlContent?: string;
+
+  /**
+   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
+   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
+   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
+   * htmlContent instead. See the **Content Components** guide.
+   */
+  markdownContent?: string;
+
+  /**
+   * Body param: The title of the changelog
+   */
+  title?: string;
+
+  /**
+   * Body param: Locale-keyed draft updates. Every listed locale must be enabled for
+   * the organization. New translations require title and nonempty htmlContent or
+   * markdownContent; existing translations preserve omitted fields. Do not combine
+   * content formats within an entry. For nonempty batches, supplied top-level
+   * content must also be nonempty. Top-level localized fields override the
+   * primary-locale entry (HTML/Markdown are one content field). An empty dictionary
+   * uses the existing flow; an empty existing-locale entry is a no-op. Nonempty
+   * batches are saved together and return the primary draft with draft
+   * availableLocales. On PATCH, if the current organization default draft is absent,
+   * return the first edited locale in alphabetical order; for an all-no-op batch,
+   * return the first listed draft in alphabetical order. The response locale
+   * identifies the selected draft. Publication is separate. Uploaded assets are not
+   * rolled back on failure.
+   */
+  translations?: ChangelogUpdateParams.Translations;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export namespace ChangelogUpdateParams {
+  /**
+   * Locale-keyed draft updates. Every listed locale must be enabled for the
+   * organization. New translations require title and nonempty htmlContent or
+   * markdownContent; existing translations preserve omitted fields. Do not combine
+   * content formats within an entry. For nonempty batches, supplied top-level
+   * content must also be nonempty. Top-level localized fields override the
+   * primary-locale entry (HTML/Markdown are one content field). An empty dictionary
+   * uses the existing flow; an empty existing-locale entry is a no-op. Nonempty
+   * batches are saved together and return the primary draft with draft
+   * availableLocales. On PATCH, if the current organization default draft is absent,
+   * return the first edited locale in alphabetical order; for an all-no-op batch,
+   * return the first listed draft in alphabetical order. The response locale
+   * identifies the selected draft. Publication is separate. Uploaded assets are not
+   * rolled back on failure.
+   */
+  export interface Translations {
+    id?: Translations.ID;
+
+    am?: Translations.Am;
+
+    ar?: Translations.Ar;
+
+    az?: Translations.Az;
+
+    bg?: Translations.Bg;
+
+    bn?: Translations.Bn;
+
+    bs?: Translations.Bs;
+
+    ca?: Translations.Ca;
+
+    cs?: Translations.Cs;
+
+    da?: Translations.Da;
+
+    de?: Translations.De;
+
+    el?: Translations.El;
+
+    en?: Translations.En;
+
+    es?: Translations.Es;
+
+    et?: Translations.Et;
+
+    fa?: Translations.Fa;
+
+    fi?: Translations.Fi;
+
+    fr?: Translations.Fr;
+
+    gu?: Translations.Gu;
+
+    ha?: Translations.Ha;
+
+    he?: Translations.He;
+
+    hi?: Translations.Hi;
+
+    hr?: Translations.Hr;
+
+    ht?: Translations.Ht;
+
+    hu?: Translations.Hu;
+
+    ig?: Translations.Ig;
+
+    it?: Translations.It;
+
+    ja?: Translations.Ja;
+
+    jv?: Translations.Jv;
+
+    kk?: Translations.Kk;
+
+    km?: Translations.Km;
+
+    kn?: Translations.Kn;
+
+    ko?: Translations.Ko;
+
+    lo?: Translations.Lo;
+
+    lt?: Translations.Lt;
+
+    lv?: Translations.Lv;
+
+    ml?: Translations.Ml;
+
+    mn?: Translations.Mn;
+
+    mr?: Translations.Mr;
+
+    ms?: Translations.Ms;
+
+    my?: Translations.My;
+
+    nb?: Translations.Nb;
+
+    ne?: Translations.Ne;
+
+    nl?: Translations.Nl;
+
+    pa?: Translations.Pa;
+
+    pl?: Translations.Pl;
+
+    ps?: Translations.Ps;
+
+    pt?: Translations.Pt;
+
+    'pt-BR'?: Translations.PtBr;
+
+    ro?: Translations.Ro;
+
+    ru?: Translations.Ru;
+
+    sd?: Translations.Sd;
+
+    si?: Translations.Si;
+
+    sk?: Translations.Sk;
+
+    sl?: Translations.Sl;
+
+    so?: Translations.So;
+
+    sr?: Translations.Sr;
+
+    sv?: Translations.Sv;
+
+    sw?: Translations.Sw;
+
+    ta?: Translations.Ta;
+
+    te?: Translations.Te;
+
+    th?: Translations.Th;
+
+    tl?: Translations.Tl;
+
+    tr?: Translations.Tr;
+
+    uk?: Translations.Uk;
+
+    ur?: Translations.Ur;
+
+    uz?: Translations.Uz;
+
+    vi?: Translations.Vi;
+
+    yo?: Translations.Yo;
+
+    'zh-CN'?: Translations.ZhCn;
+
+    'zh-TW'?: Translations.ZhTw;
+  }
+
+  export namespace Translations {
+    export interface ID {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Am {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ar {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Az {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bg {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Bs {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ca {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Cs {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Da {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface De {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface El {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface En {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Es {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Et {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fa {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Fr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Gu {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ha {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface He {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ht {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Hu {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ig {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface It {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ja {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Jv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Kk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Km {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Kn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ko {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lo {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lt {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Lv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ml {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Mn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Mr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ms {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface My {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Nb {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ne {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Nl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pa {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ps {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Pt {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface PtBr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ro {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ru {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sd {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Si {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface So {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sv {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Sw {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ta {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Te {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Th {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Tl {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Tr {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Uk {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Ur {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Uz {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Vi {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface Yo {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface ZhCn {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+
+    export interface ZhTw {
+      featuredImage?: string;
+
+      htmlContent?: string;
+
+      markdownContent?: string;
+
+      title?: string;
+    }
+  }
 }
 
 export interface ChangelogListParams extends CursorPageParams {
@@ -1244,6 +3195,7 @@ export declare namespace Changelogs {
   export {
     type Changelog as Changelog,
     type PublishUnpublishSuccess as PublishUnpublishSuccess,
+    type ChangelogRetrieveResponse as ChangelogRetrieveResponse,
     type ChangelogDeleteResponse as ChangelogDeleteResponse,
     type ChangelogsCursorPage as ChangelogsCursorPage,
     type ChangelogCreateParams as ChangelogCreateParams,