@encorekit/web-sdk 2.2.0 → 2.3.0

package/types/api/generated/types.d.ts

@@ -104,6 +104,10 @@ export interface paths {
                                 heroImageUrl?: string | null;
                                 /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
                                 termsUrl?: string | null;
+                                /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+                                displayProperties?: {
+                                    [key: string]: unknown;
+                                };
                                 /** Format: date-time */
                                 createdAt: string;
                                 /** Format: date-time */
@@ -152,6 +156,8 @@ export interface paths {
                                         title: string;
                                         subtitle: string;
                                         ctaButtonText?: string;
+                                        /** @description Optional https image for this step. Absent: the step has none. */
+                                        imageUrl?: string;
                                     }[] | null;
                                     /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
                                     quickInstructions: string | null;
@@ -231,6 +237,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -285,6 +293,7 @@ export interface paths {
                             longitude?: string;
                             dateOfBirth?: string;
                             gender?: string;
+                            /** @description BCP 47 language tag; only the language subtag is used for creative locale resolution, and only when the app has that language enabled. Falls back to Accept-Language, then the app default locale. */
                             language?: string;
                             subscriptionTier?: string;
                             monthsSubscribed?: string;
@@ -325,8 +334,15 @@ export interface paths {
                         variantId?: string;
                         /** @description Publisher-defined surface label for where the offer is shown (e.g. 'paywall', 'onboarding', 'settings'). Stamped onto the sdk_offer_requested event so publisher analytics can break the funnel out by placement. An Encore admin can also configure a per-placement offer rule for an app, in which case this label SELECTS and ORDERS the offers returned for that placement; with no rule configured, which is the default for every app, it stays analytics-only and changes nothing about what is served. Max 64 chars. SDKs may send their own auto-generated `placement_<8 hex>` id when the publisher supplied none — that is expected and is folded into the '(unlabeled)' bucket at read time; do NOT substitute '(unlabeled)' or an empty string yourself. */
                         placementId?: string;
+                        /**
+                         * @description Which Encore surface is being filled. Ignored while OFFERS_SEARCH_RESOLVES_SURFACE is off. With it on and no variantId, the server resolves the variant for this use case (and the placementId pin) as GET /config does; a sent variantId always wins. Absent or unrecognised: today's behaviour (churn-intervention). Never a 400.
+                         * @enum {string}
+                         */
+                        useCase?: "churn-intervention" | "post-action-reward";
                         /** @description Strict unlock mode: only include campaigns whose postback latency is less than or equal to this value (in milliseconds). Omit for no filtering. Bounded 1000..120000. */
                         maxPostbackTimeMs?: number;
+                        /** @description Send only when this placement carries the app's own prize for a reward-for-trying Yes: the app's daily prize limit from its SDK configuration (PublisherRewardPolicy), clamped server-side to 1..10. The response then carries publisherRewardPromise. Omit it and nothing changes. */
+                        publisherRewardDailyLimit?: number;
                         /** @description Request-scoped serving context. Unknown keys are ignored. */
                         context?: {
                             /** @description Request-scoped activity the user is engaged in at serve time (what the surface is being used for, not a persisted user property). Recognized values: laundry, vending, car_wash, air_vacuum, amusement. Any other value is accepted and recorded on serve analytics, so unrecognized activities show up in reporting rather than failing the request. Does not change which offers are served today. */
@@ -409,6 +425,10 @@ export interface paths {
                                 heroImageUrl?: string | null;
                                 /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
                                 termsUrl?: string | null;
+                                /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+                                displayProperties?: {
+                                    [key: string]: unknown;
+                                };
                                 /** Format: date-time */
                                 createdAt: string;
                                 /** Format: date-time */
@@ -457,6 +477,8 @@ export interface paths {
                                         title: string;
                                         subtitle: string;
                                         ctaButtonText?: string;
+                                        /** @description Optional https image for this step. Absent: the step has none. */
+                                        imageUrl?: string;
                                     }[] | null;
                                     /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
                                     quickInstructions: string | null;
@@ -523,11 +545,41 @@ export interface paths {
                                 category?: string | null;
                                 /** @description The gift-sheet group this campaign files under: "Watch & listen", "Money" or "Everyday". Derived from `category` by the server so a native chip strip shows what web tabs show without holding the taxonomy map. Always set: an absent, blank or unmapped category files under "Everyday", so every offer sits in some group. Whether a strip is worth drawing is the client's call, because only it knows which offers its sheet lists. /offers/search only: web-sdk holds its own copy of the map and groups `category` itself. */
                                 categoryGroup?: string | null;
+                                /** @description `category` in the response locale, for display only. Group and filter on `category`, which stays English. Null when `category` is null. /offers/search only. */
+                                categoryDisplayName?: string | null;
+                                /** @description `categoryGroup` in the response locale, for display only. Group on `categoryGroup`, which stays English. /offers/search only. */
+                                categoryGroupDisplayName?: string | null;
                                 /** @description Estimated time from the user tapping this offer to the reward being confirmed, from recent real conversions (on demo offers, from the demo advertiser's configured behavior instead). Half confirm within medianSeconds, 9 in 10 within p90Seconds. Not a guarantee: to show a wait, use p90Seconds. Null when there is no current estimate (too few recent conversions, data more than 7 days old, or an offer that does not confirm through the advertiser); say nothing about timing then. */
                                 rewardConfirmationTime?: {
                                     medianSeconds: number;
                                     p90Seconds: number;
                                 } | null;
+                                /** @description Campaign claim-URL query parameters, keys verbatim (e.g. {"af_rid":"TRANSACTION_ID"}); equals the served creative's whenever one exists. Always pair it with the offer's destinationUrl, never with a creative's, and never build a claim URL from an absent or empty value. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                trackingParameters?: {
+                                    [key: string]: unknown;
+                                } | null;
+                                /** @description Campaign call-to-action text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                ctaText?: string | null;
+                                /** @description Campaign description, localized like creatives. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                description?: string | null;
+                                /** @description Campaign step-by-step instructions, same shape as a creative's. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                instructions?: {
+                                    title: string;
+                                    subtitle: string;
+                                    ctaButtonText?: string;
+                                    /** @description Optional https image for this step. Absent: the step has none. */
+                                    imageUrl?: string;
+                                }[] | null;
+                                /** @description Campaign one-line instructions. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                quickInstructions?: string | null;
+                                /** @description Campaign logo override; null means use organization.logoUrl. Plain string, not format: uri, so one bad value cannot fail a whole Android decode. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                logoUrl?: string | null;
+                                /** @description Campaign card title. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                title?: string | null;
+                                /** @description Campaign card subtitle. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                subtitle?: string | null;
+                                /** @description Campaign tooltip text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                                tooltipText?: string | null;
                             }[];
                             metadata: {
                                 /** @description Total offers available */
@@ -545,6 +597,8 @@ export interface paths {
                             };
                             /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
                             locale?: string;
+                            /** @description Whether this user may still be granted the app's prize for a reward-for-trying Yes: true while the prizes granted to them in the last 24 hours (rolling) are under publisherRewardDailyLimit. Present only when the request sent publisherRewardDailyLimit. Offers this user already completed or said Yes to are never served, so this answers the daily limit only. Absent (an older backend, or no limit sent) means no promise. Not a grant: the self-report's granted answer is final. */
+                            publisherRewardPromise?: boolean;
                             error?: string | null;
                         };
                     };
@@ -558,6 +612,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -570,6 +626,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -582,6 +640,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -594,6 +654,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -614,7 +676,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Rebrokering catalog: the full set of offers your app may serve to a given end user, to render on your own surface. Two hard, server-enforced filters always apply: entitlement (your app's opt-outs + whitelist) and geo (offers not redeemable in the end user's country are dropped: non-redeemable offers are never returned). Serve path requires `userId` (a stable end-user identifier) and geo (`countryCode`, or the end user's IP forwarded via X-Forwarded-For); missing either is a 400. Each returned creative carries a tokenized `clickUrl`: route the end user there on tap and it records an attributed transaction (bound to your app, the offer, the creative, and the userId) then 302s to the advertiser. Filter to your curated offer IDs and order CLIENT-SIDE, falling back to other returned offers so your surface is never empty (the server does not narrow to your picks). Set `includeAllRegions: true` for config-time discovery of your full addressable inventory (skips geo, needs no userId, returns no clickUrls; each offer carries targetCountries); not for display. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). */
+        /** @description Rebrokering catalog: the full set of offers your app may serve to a given end user, to render on your own surface. Two hard, server-enforced filters always apply: entitlement (your app's opt-outs + whitelist) and geo (offers not redeemable in the end user's country are dropped: non-redeemable offers are never returned). Serve path requires `userId` (a stable end-user identifier) and geo (`countryCode`, or the end user's IP forwarded via X-Forwarded-For); missing either is a 400. On the serve path, offers this end user already completed (a confirmed conversion, or a Yes they reported through an Encore SDK) are left out. Each returned creative carries a tokenized `clickUrl`: route the end user there on tap and it records an attributed transaction (bound to your app, the offer, the creative, and the userId) then 302s to the advertiser. Filter to your curated offer IDs and order CLIENT-SIDE, falling back to other returned offers so your surface is never empty (the server does not narrow to your picks). Set `includeAllRegions: true` for config-time discovery of your full addressable inventory (skips geo, needs no userId, returns no clickUrls; each offer carries targetCountries); not for display. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*). */
         post: {
             parameters: {
                 query?: never;
@@ -625,7 +687,7 @@ export interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** @description Stable identifier for the END USER you are rendering offers to (any opaque string; does not need to be PII). REQUIRED on the serve path — it is bound into each offer's clickUrl so a click records a transaction attributed to (your app, the offer, the creative, this user), and it drives per-user fraud controls (trial caps, retake blocking) at click time. Use the same value across renders for the same user. Not required when includeAllRegions is set (config mode returns no clickUrls). */
+                        /** @description Stable identifier for the END USER you are rendering offers to (any opaque string; does not need to be PII). REQUIRED on the serve path — it is bound into each offer's clickUrl so a click records a transaction attributed to (your app, the offer, the creative, this user), it drives per-user fraud controls (trial caps, retake blocking) at click time, and on the serve path it leaves out offers this user already completed. Use the same value across renders for the same user. Not required when includeAllRegions is set (config mode returns no clickUrls). */
                         userId?: string;
                         /** @description Optional identifier for the operator/sub-publisher on whose behalf offers are shown. Carried through as an analytics dimension. Defaults to userId when omitted. */
                         clientId?: string;
@@ -638,6 +700,8 @@ export interface paths {
                         platform?: "android" | "ios" | "web";
                         /** @description Optional publisher-defined label for the surface this offer is shown on (e.g. 'cancel_flow', 'home_feed', 'post_purchase'). Stamped onto the impression AND onto the click it produces, so publisher analytics can break the funnel out by placement. Normalised server-side: a blank value is treated as absent, anything longer than 64 characters is TRUNCATED rather than rejected, and the stored label NEVER carries leading or trailing whitespace, including after truncation, so ' my label ' and 'my label' are always one placement and can never show up as two rows. Case IS significant: 'Cancel_Flow' and 'cancel_flow' are different placements. Omit it and this traffic groups under '(unlabeled)', the same bucket as an SDK integration that supplies no placement. A per-placement offer rule NEVER applies here. `/offers/catalog` returns inventory rather than a served set, so a rule configured for this label does not select or order what comes back. Scope an inventory pull on your own filters, never on a rule. */
                         placementId?: string;
+                        /** @description Optional BCP 47 language tag (e.g. "es", "pt-BR"), from the host's language override. Wins over Accept-Language; only the language subtag is used (nb is served as no; iw, in, ji, jw as he, id, yi, jv), and only when the app has it enabled, else Accept-Language, then the app default. A tag the SDKs would refuse (malformed, underscores, or an extended language subtag such as zh-yue-HK) is 400 with details.code INVALID_LANGUAGE. */
+                        language?: string;
                         /** @description CONFIG-TIME ONLY. When true, skips geo-filtering and returns the full addressable inventory for your app (entitlement still applies), with each offer's targetCountries — use this to build your curation. Do NOT use for offers displayed to an end user; those must come from a geo-scoped request (countryCode or forwarded IP). When true, no geography signal is required and countryCode is ignored. */
                         includeAllRegions?: boolean;
                         /** @description Optional page size (1..100). OMIT to return ALL eligible offers (the default) — catalogs are small enough that you normally take the whole set and curate client-side. Provide only if you want to page (with offset). */
@@ -680,6 +744,10 @@ export interface paths {
                                 isDemo?: boolean;
                                 /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
                                 termsUrl?: string | null;
+                                /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+                                displayProperties?: {
+                                    [key: string]: unknown;
+                                };
                                 /** @description Estimated time from the user tapping this offer to the reward being confirmed, from recent real conversions (on demo offers, from the demo advertiser's configured behavior instead). Half confirm within medianSeconds, 9 in 10 within p90Seconds. Not a guarantee: to show a wait, use p90Seconds. Null when there is no current estimate (too few recent conversions, data more than 7 days old, or an offer that does not confirm through the advertiser); say nothing about timing then. */
                                 rewardConfirmationTime?: {
                                     medianSeconds: number;
@@ -712,6 +780,8 @@ export interface paths {
                                         title: string;
                                         subtitle: string;
                                         ctaButtonText?: string;
+                                        /** @description Optional https image for this step. Absent: the step has none. */
+                                        imageUrl?: string;
                                     }[] | null;
                                     /** @description A short one line version of the instructions, e.g. "sign up, complete one survey". Null or absent: the creative has none. */
                                     quickInstructions?: string | null;
@@ -744,6 +814,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -756,6 +828,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -768,6 +842,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -807,7 +883,7 @@ export interface paths {
                         attributes: {
                             /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
                             countryCode: string;
-                            /** @description BCP 47 language tag — drives creative locale resolution (e.g., 'en', 'es'). */
+                            /** @description BCP 47 language tag; only the language subtag is used for creative locale resolution, and only when the app has that language enabled. Falls back to Accept-Language, then the app default locale. */
                             language: string;
                             /**
                              * @description Recipient's device platform — drives creative compatibility filtering. Optional: omit for a platform='api' app to receive all eligible offers untrimmed; device-SDK apps always send it. 'api' is not a valid value here.
@@ -875,6 +951,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -887,6 +965,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -899,6 +979,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -938,7 +1020,7 @@ export interface paths {
                         attributes: {
                             /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
                             countryCode: string;
-                            /** @description BCP 47 language tag — drives creative locale resolution (e.g., 'en', 'es'). */
+                            /** @description BCP 47 language tag; only the language subtag is used for creative locale resolution, and only when the app has that language enabled. Falls back to Accept-Language, then the app default locale. */
                             language: string;
                             /**
                              * @description Recipient's device platform — drives creative compatibility filtering. Optional: omit for a platform='api' app to receive all eligible offers untrimmed; device-SDK apps always send it. 'api' is not a valid value here.
@@ -1014,6 +1096,10 @@ export interface paths {
                                 heroImageUrl?: string | null;
                                 /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
                                 termsUrl?: string | null;
+                                /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+                                displayProperties?: {
+                                    [key: string]: unknown;
+                                };
                                 /** @description Display name of the campaign category, e.g. "Music and Audio". Free string: the taxonomy is admin-editable, so accept any value. */
                                 category?: string | null;
                                 /** @description Step by step instructions from the creative, translated like the title. Null or absent: the creative has none. */
@@ -1021,6 +1107,8 @@ export interface paths {
                                     title: string;
                                     subtitle: string;
                                     ctaButtonText?: string;
+                                    /** @description Optional https image for this step. Absent: the step has none. */
+                                    imageUrl?: string;
                                 }[] | null;
                                 /** @description A short one line version of the instructions, e.g. "sign up, complete one survey". Null or absent: the creative has none. */
                                 quickInstructions?: string | null;
@@ -1042,6 +1130,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1054,6 +1144,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1066,6 +1158,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1129,6 +1223,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1141,6 +1237,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1153,6 +1251,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1173,7 +1273,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Create a new transaction for a specific campaign */
+        /** @description Create a new transaction for a specific campaign. 409 with code 'offerAlreadyCompleted' when this user already completed the offer, or said Yes to it through a self-report: drop the offer from the list rather than retrying. The app-wide trial-limit 409 carries no code. */
         post: {
             parameters: {
                 query?: never;
@@ -1230,6 +1330,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1242,6 +1344,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1254,6 +1358,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1266,6 +1372,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1278,6 +1386,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1341,6 +1451,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1353,6 +1465,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1365,6 +1479,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1377,6 +1493,133 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/publisher/sdk/v1/transactions/{transactionId}/self-report": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** @description Record that the user answered "Yes, I completed it" to a reward-for-trying offer, and decide whether the app may grant its own prize. Send it on EVERY tapped Yes, prize or not: the Yes is stored per person (the app's user id), so the offer is hidden from that person on every surface and a re-claim is refused (409 offerAlreadyCompleted), including after a reinstall or on a second device. granted is true only for the first Yes per person per offer, while the person is under the app's daily limit (a rolling 24 hours). Treat no answer as no prize. Idempotent on reportId. Never changes the transaction: no status, payout, entitlement or webhook. 404 when the transaction does not belong to this app, or userId is not the current user id of the person who claimed it. The server cannot tell an identified user from an SDK-generated anonymous id: an app that wants prizes kept to signed-in users must gate the promise client-side. */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    transactionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description The SDK's CURRENT user id at the moment the report is sent (not the id captured when the user tapped Yes). Must equal the current app user id of the user who owns the transaction, or the request is a 404. */
+                        userId: string;
+                        /**
+                         * Format: uuid
+                         * @description Minted once per tapped Yes and reused on every retry of that Yes, with the same body. A retry gets the same granted. On a refused Yes the server keeps only that no prize was granted, so the retry's reason is derived from the retry's own body (daily_cap when it carries publisherRewardId, else no_prize): resend the body unchanged.
+                         */
+                        reportId: string;
+                        /** @description Present only when a prize was promised for this Yes. Absent: the Yes is still recorded (the offer is hidden and cannot be re-claimed) and granted is false with reason no_prize. */
+                        publisherRewardId?: string;
+                        /** @description The app's daily prize limit from its SDK configuration. Required when publisherRewardId is present. Clamped server-side to 1..10. */
+                        dailyLimit?: number;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            success: true;
+                            /** @description Whether the app may grant its prize for this Yes. True only for the first Yes per person per offer, under the daily limit. The ONLY source of prize eligibility: no answer (timeout, offline, 5xx, 404) means no prize. */
+                            granted: boolean;
+                            /**
+                             * @description Present when granted is false.
+                             * @enum {string}
+                             */
+                            reason?: "per_offer" | "daily_cap" | "no_prize";
+                            /**
+                             * Format: date-time
+                             * @description When the server recorded this person's Yes for this offer (the first one, on a retry or a second device).
+                             */
+                            reportedAt: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            error: string;
+                            details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1389,6 +1632,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1448,6 +1693,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1460,6 +1707,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1472,6 +1721,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1655,6 +1906,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1667,6 +1920,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1679,6 +1934,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1854,6 +2111,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1866,6 +2125,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -1878,6 +2139,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2059,6 +2322,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2071,6 +2336,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2150,6 +2417,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2162,6 +2431,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2174,6 +2445,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2304,6 +2577,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2316,6 +2591,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2336,7 +2613,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** @description Get unified SDK configuration including SDUI, entitlements, experiments, and remote config. This endpoint replaces /ui-config with a cleaner structure. Entitlement mode is implicit: if entitlements.iap.productId exists, use IAP mode; otherwise use Native mode. Pass `useCase` to configure a surface other than churn-intervention; the response echoes it as ui.useCase. `demoVariant` names an SDUI variant to serve for this request. It is honoured on a TEST key (pk_test_*) for any app, and on a live key only for Encore's own demo apps; for every other app it is ignored silently (never an error). It exists for demos and previews: Encore's own demo pages, and a publisher who wants to see the other variants against their own test key. Requesting a surface is all it takes to be served it — no setup call is required. A surface Encore has explicitly switched off for this app, or one with no variant available, returns ui.template: null — clients must no-op, never reuse another use case's template. */
+        /** @description Get unified SDK configuration including SDUI, entitlements, experiments, and remote config. This endpoint replaces /ui-config with a cleaner structure. Entitlement mode is implicit: if entitlements.iap.productId exists, use IAP mode; otherwise use Native mode. Pass `useCase` to configure a surface other than churn-intervention; the response echoes it as ui.useCase. `demoVariant` names an SDUI variant to serve for this request. It is honoured on a TEST key (pk_test_*) for any app, and on a live key only for Encore's own demo apps; for every other app it is ignored silently (never an error). It exists for demos and previews: Encore's own demo pages, and a publisher who wants to see the other variants against their own test key. `placementId` selects a variant an admin pinned to that placement, in `ui` only; any label without a pin resolves as before. Requesting a surface is all it takes to be served it — no setup call is required. A surface Encore has explicitly switched off for this app, or one with no variant available, returns ui.template: null — clients must no-op, never reuse another use case's template. */
         get: {
             parameters: {
                 query: {
@@ -2350,6 +2627,8 @@ export interface paths {
                     useCase?: "churn-intervention" | "post-action-reward";
                     /** @description Demos and previews only. The SDUI variant file stem to serve for this request, e.g. 'giftUnwrap'. Honoured on a TEST key (pk_test_*) for any app. On a live key it is honoured only for Encore's own demo apps; for every other app it is ignored silently and resolution is unchanged, never an error. Intended for Encore's internal demos and for a publisher previewing the other variants against their own test key. An honoured value bypasses app targeting, experiments and arm weights, and WIDENS the status filter from 'active' to 'active' or 'valid' — the filter is widened, not removed, so a draft, testing, invalid or archived variant is still refused. The use-case partition, the per-app kill switch and the SDK version gate all still apply. Note that a test key also serves the demo campaign catalog rather than live advertiser inventory, and tags the request as test traffic in analytics. */
                     demoVariant?: string;
+                    /** @description The publisher's placement label for the surface being configured, e.g. 'email_code'. Optional. When an admin has pinned an SDUI variant to this (app, placement), `ui` serves that variant instead of the experiment assignment, provided it is active or valid, matches the requested use case and passes its SDK version gate and app targeting. Otherwise, and for any label with no pin, resolution is unchanged. Never a 4xx on any input. Applies to `ui` only; the `useCases` prefetch block is never pinned. */
+                    placementId?: string;
                 };
                 header?: never;
                 path?: never;
@@ -2419,6 +2698,16 @@ export interface paths {
                                         rewardHeadline?: string | null;
                                         /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                                         rewardSubheadline?: string | null;
+                                        /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                                        rewardCta?: string | null;
+                                        /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                                        rewardDecline?: string | null;
+                                        /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                                        rewardBadge?: string | null;
+                                        /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                                        rewardMoreGifts?: string | null;
+                                        /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                                        rewardOtherGifts?: string | null;
                                     };
                                     /** @description Appearance values */
                                     appearance: {
@@ -2437,6 +2726,21 @@ export interface paths {
                                         /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                                         appstoreIcon: string | null;
                                     };
+                                    /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                                    strings?: {
+                                        [key: string]: string;
+                                    };
+                                    /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                                    plurals?: {
+                                        [key: string]: {
+                                            zero?: string;
+                                            one?: string;
+                                            two?: string;
+                                            few?: string;
+                                            many?: string;
+                                            other: string;
+                                        };
+                                    };
                                 };
                             };
                             /** @description Assigned variant for every use case this app is enabled for other than the one REQUESTED, so the SDK can cache them at identify(). When the single-enabled-use-case fallback serves a different surface in `ui`, that surface also appears here under its own key, so a client that files `ui` under the requested use case still finds it. `ui` is unchanged; un-upgraded decoders ignore this key. */
@@ -2487,6 +2791,16 @@ export interface paths {
                                             rewardHeadline?: string | null;
                                             /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                                             rewardSubheadline?: string | null;
+                                            /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                                            rewardCta?: string | null;
+                                            /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                                            rewardDecline?: string | null;
+                                            /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                                            rewardBadge?: string | null;
+                                            /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                                            rewardMoreGifts?: string | null;
+                                            /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                                            rewardOtherGifts?: string | null;
                                         };
                                         /** @description Appearance values */
                                         appearance: {
@@ -2505,6 +2819,21 @@ export interface paths {
                                             /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                                             appstoreIcon: string | null;
                                         };
+                                        /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                                        strings?: {
+                                            [key: string]: string;
+                                        };
+                                        /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                                        plurals?: {
+                                            [key: string]: {
+                                                zero?: string;
+                                                one?: string;
+                                                two?: string;
+                                                few?: string;
+                                                many?: string;
+                                                other: string;
+                                            };
+                                        };
                                     };
                                 };
                                 "post-action-reward"?: {
@@ -2553,6 +2882,16 @@ export interface paths {
                                             rewardHeadline?: string | null;
                                             /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                                             rewardSubheadline?: string | null;
+                                            /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                                            rewardCta?: string | null;
+                                            /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                                            rewardDecline?: string | null;
+                                            /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                                            rewardBadge?: string | null;
+                                            /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                                            rewardMoreGifts?: string | null;
+                                            /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                                            rewardOtherGifts?: string | null;
                                         };
                                         /** @description Appearance values */
                                         appearance: {
@@ -2571,6 +2910,21 @@ export interface paths {
                                             /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                                             appstoreIcon: string | null;
                                         };
+                                        /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                                        strings?: {
+                                            [key: string]: string;
+                                        };
+                                        /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                                        plurals?: {
+                                            [key: string]: {
+                                                zero?: string;
+                                                one?: string;
+                                                two?: string;
+                                                few?: string;
+                                                many?: string;
+                                                other: string;
+                                            };
+                                        };
                                     };
                                 };
                             };
@@ -2613,6 +2967,8 @@ export interface paths {
                             };
                             /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
                             locale?: string;
+                            /** @description Placement labels for this app that carry a placement rule or pinned variant. Present whenever the app's placement rules can be read; empty when none. Clients scope their offers cache by placement only for labels in this list; when the field is absent (older server) clients keep their pre-2.4 behaviour. */
+                            ruledPlacements?: string[];
                         };
                     };
                 };
@@ -2625,6 +2981,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2637,6 +2995,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2709,6 +3069,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2721,6 +3083,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2745,7 +3109,7 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /** @description Update user identity (anonymous→identified). Updates the user's app_user_id. Called when developer calls SDK.identify() after login. */
+        /** @description Update user identity (anonymous→identified). Updates the user's app_user_id. Called when developer calls SDK.identify() after login. When newUserId already exists (the person signed in before, e.g. on another device), the anonymous user's completed and self-reported offers are copied onto that account, so they stay hidden and cannot be re-claimed. The copy is taken once, at this call: send any queued self-reports BEFORE it. A report for the anonymous user's claim that arrives afterwards is refused if it carries newUserId (404), and recorded on the anonymous user only, not this account, if it carries currentUserId. */
         patch: {
             parameters: {
                 query?: never;
@@ -2795,6 +3159,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2807,6 +3173,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2828,7 +3196,9 @@ export interface paths {
          *
          *     Precedence: an attribute sent on an /offers/search or /offers/feed request always WINS over the stored one. The stored set only fills an attribute the request omits.
          *
-         *     AGE. Send `age` as a whole-number integer. If you hold only a RANGE, send its LOWEST end — "13-17" is sent as 13, never 15 and never 17. Sending the middle of a range silently defeats the under-age check: flooring can never mask a minor, a midpoint can. An age below 18 restricts that user to age-appropriate inventory ranked by the app-level bandit, with NO per-user personalisation — offers are still served. For such a user only `age`, `countryCode` and `language` are STORED — the attributes that decide where an offer may legally appear and which creative locale renders; everything else you sent is discarded, `custom` included, and the response reports `minor`. The instant you sent the set is recorded, so a stored age is aged forward rather than frozen. `dateOfBirth` is refused: `age` carries the same targeting value with far less identifying power.
+         *     LANGUAGE is accepted and ignored: it is never stored. The hosted page and the SDKs send it on each request, else Accept-Language decides.
+         *
+         *     AGE. Send `age` as a whole-number integer. If you hold only a RANGE, send its LOWEST end — "13-17" is sent as 13, never 15 and never 17. Sending the middle of a range silently defeats the under-age check: flooring can never mask a minor, a midpoint can. An age below 18 restricts that user to age-appropriate inventory ranked by the app-level bandit, with NO per-user personalisation — offers are still served. For such a user only `age` and `countryCode` are STORED — the attributes that decide where an offer may legally appear; everything else you sent is discarded, `custom` included, and the response reports `minor`. The instant you sent the set is recorded, so a stored age is aged forward rather than frozen. `dateOfBirth` is refused: `age` carries the same targeting value with far less identifying power.
          *
          *     GATED KEYS. email, firstName, lastName, mobile, phoneNumber, postcode, postalCode, latitude, longitude and gender are accepted ONLY from an app whose audience is declared adults_only (store-rated 18+). Any other status, including the default, is refused with 400. `age` is NOT gated — it is accepted from any app, because it is what restricts what a user is shown rather than something that identifies them. Unrecognised keys are refused rather than ignored. Authentication: publishable key (X-API-Key: pk_live_* / pk_test_*).
          */
@@ -2848,6 +3218,7 @@ export interface paths {
                         attributes: {
                             /** @description ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA"). */
                             countryCode?: string;
+                            /** @description Accepted for compatibility and ignored: the language is never stored. Send it on each request (attributes.language, or Accept-Language) instead. */
                             language?: string;
                             city?: string;
                             state?: string;
@@ -2895,7 +3266,7 @@ export interface paths {
                             userId: string;
                             /** @description ISO 8601 instant the set was recorded; what a stored age is aged forward from */
                             storedAt: string;
-                            /** @description True when the supplied age was under 18. Offers are STILL served to this user — from age-appropriate inventory only, ranked by the app-level bandit, with no per-user personalisation. Only `age`, `countryCode` and `language` are kept for this user. Everything else you sent is DISCARDED, including `custom`, `city`, `state`, `region` and the subscription and billing fields — a profile that may not be targeted on has no purpose. Re-send the set once they are 18 and it is stored in full. */
+                            /** @description True when the supplied age was under 18. Offers are STILL served to this user — from age-appropriate inventory only, ranked by the app-level bandit, with no per-user personalisation. Only `age` and `countryCode` are kept for this user. Everything else you sent is DISCARDED, including `custom`, `city`, `state`, `region` and the subscription and billing fields — a profile that may not be targeted on has no purpose. Re-send the set once they are 18 and it is stored in full. */
                             minor: boolean;
                         };
                     };
@@ -2909,6 +3280,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2921,6 +3294,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2933,6 +3308,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -2999,6 +3376,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3011,6 +3390,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3067,6 +3448,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3079,6 +3462,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3091,6 +3476,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3103,6 +3490,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3169,6 +3558,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3181,6 +3572,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3193,6 +3586,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3229,6 +3624,8 @@ export interface paths {
                         campaignId: string;
                         /** Format: email */
                         email: string;
+                        /** @description Optional BCP 47 language tag (e.g. "es", "pt-BR"), from the host's language override. Wins over Accept-Language; only the language subtag is used (nb is served as no; iw, in, ji, jw as he, id, yi, jv), and only when the app has it enabled, else Accept-Language, then the app default. A tag the SDKs would refuse (malformed, underscores, or an extended language subtag such as zh-yue-HK) is 400 with details.code INVALID_LANGUAGE. The lead's emails go out in the language served. */
+                        language?: string;
                         /** @description Trial length in days as reported by StoreKit; drives reminder scheduling. */
                         trialDurationDays?: number | null;
                         /**
@@ -3270,6 +3667,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3282,6 +3681,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3294,6 +3695,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3357,6 +3760,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3369,6 +3774,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3381,6 +3788,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3445,6 +3854,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3457,6 +3868,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3469,6 +3882,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3481,6 +3896,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3493,6 +3910,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3556,6 +3975,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3568,6 +3989,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3580,6 +4003,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3592,6 +4017,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3604,6 +4031,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3616,6 +4045,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3695,6 +4126,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3707,6 +4140,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3719,6 +4154,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3799,6 +4236,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3811,6 +4250,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3823,6 +4264,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3835,6 +4278,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3894,6 +4339,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3906,6 +4353,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3918,6 +4367,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3930,6 +4381,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -3994,6 +4447,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4006,6 +4461,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4018,6 +4475,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4030,6 +4489,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4042,6 +4503,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4160,6 +4623,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4172,6 +4637,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4184,6 +4651,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4266,6 +4735,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4278,6 +4749,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4290,6 +4763,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4367,6 +4842,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4379,6 +4856,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4391,6 +4870,8 @@ export interface paths {
                         "application/json": {
                             error: string;
                             details?: unknown;
+                            /** @description Machine-readable reason, set only on the few errors a client must branch on (each route that sets one says so in its description) and absent on every other. Treat an unknown value as absent. */
+                            code?: string;
                         };
                     };
                 };
@@ -4473,6 +4954,16 @@ export interface components {
                         rewardHeadline?: string | null;
                         /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                         rewardSubheadline?: string | null;
+                        /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                        rewardCta?: string | null;
+                        /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                        rewardDecline?: string | null;
+                        /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                        rewardBadge?: string | null;
+                        /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                        rewardMoreGifts?: string | null;
+                        /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                        rewardOtherGifts?: string | null;
                     };
                     /** @description Appearance values */
                     appearance: {
@@ -4491,6 +4982,21 @@ export interface components {
                         /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                         appstoreIcon: string | null;
                     };
+                    /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                    strings?: {
+                        [key: string]: string;
+                    };
+                    /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                    plurals?: {
+                        [key: string]: {
+                            zero?: string;
+                            one?: string;
+                            two?: string;
+                            few?: string;
+                            many?: string;
+                            other: string;
+                        };
+                    };
                 };
             };
             /** @description Assigned variant for every use case this app is enabled for other than the one REQUESTED, so the SDK can cache them at identify(). When the single-enabled-use-case fallback serves a different surface in `ui`, that surface also appears here under its own key, so a client that files `ui` under the requested use case still finds it. `ui` is unchanged; un-upgraded decoders ignore this key. */
@@ -4541,6 +5047,16 @@ export interface components {
                             rewardHeadline?: string | null;
                             /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                             rewardSubheadline?: string | null;
+                            /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                            rewardCta?: string | null;
+                            /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                            rewardDecline?: string | null;
+                            /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                            rewardBadge?: string | null;
+                            /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                            rewardMoreGifts?: string | null;
+                            /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                            rewardOtherGifts?: string | null;
                         };
                         /** @description Appearance values */
                         appearance: {
@@ -4559,6 +5075,21 @@ export interface components {
                             /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                             appstoreIcon: string | null;
                         };
+                        /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                        strings?: {
+                            [key: string]: string;
+                        };
+                        /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                        plurals?: {
+                            [key: string]: {
+                                zero?: string;
+                                one?: string;
+                                two?: string;
+                                few?: string;
+                                many?: string;
+                                other: string;
+                            };
+                        };
                     };
                 };
                 "post-action-reward"?: {
@@ -4607,6 +5138,16 @@ export interface components {
                             rewardHeadline?: string | null;
                             /** @description Subheadline for the reward template. NON-NULL whenever ui.useCase is 'post-action-reward', for the same reason as rewardHeadline — the template references ${rewardSubheadline} unconditionally. Resolution: app_use_cases.subheadline, else the shipped default. */
                             rewardSubheadline?: string | null;
+                            /** @description Primary button label for the reward template. Resolution: the variant's own defaultCopy.cta. Null when the variant declares none, in which case its template carries a literal instead. An SDK that predates this field receives the wording inlined in the template, not a token. */
+                            rewardCta?: string | null;
+                            /** @description Decline button label for the reward template. Same resolution and same null meaning as rewardCta. */
+                            rewardDecline?: string | null;
+                            /** @description Badge on the highlighted offer card, e.g. 'Most claimed'. Same resolution and same null meaning as rewardCta. */
+                            rewardBadge?: string | null;
+                            /** @description Label on the card that opens the rest of the offer list, e.g. 'Show more gifts'. Same resolution and same null meaning as rewardCta. */
+                            rewardMoreGifts?: string | null;
+                            /** @description Header above the rest of the offer list, e.g. 'Other gifts'. Same resolution and same null meaning as rewardCta. */
+                            rewardOtherGifts?: string | null;
                         };
                         /** @description Appearance values */
                         appearance: {
@@ -4625,6 +5166,21 @@ export interface components {
                             /** @description App icon URL (App Store artwork for mobile apps, fetched favicon for web apps). Web SDK uses it as the default host logo when display.logoUrl is not set. */
                             appstoreIcon: string | null;
                         };
+                        /** @description Words the SDK says itself, translated into the response `locale`, by string id (e.g. 'card.claim'). Only ids that locale has; for any other id, and whenever the key is absent, use the SDK's own English. Never served for 'en'. Placeholders use ${name}. Populated in `ui.values` only, not in `useCases`. */
+                        strings?: {
+                            [key: string]: string;
+                        };
+                        /** @description Count-dependent SDK strings (e.g. 'unit.month'), translated into the response `locale`, by string id. Same id namespace as `strings`; an id appears in only one of the two. Same fallback rules as `strings`. */
+                        plurals?: {
+                            [key: string]: {
+                                zero?: string;
+                                one?: string;
+                                two?: string;
+                                few?: string;
+                                many?: string;
+                                other: string;
+                            };
+                        };
                     };
                 };
             };
@@ -4667,6 +5223,8 @@ export interface components {
             };
             /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
             locale?: string;
+            /** @description Placement labels for this app that carry a placement rule or pinned variant. Present whenever the app's placement rules can be read; empty when none. Clients scope their offers cache by placement only for labels in this list; when the field is absent (older server) clients keep their pre-2.4 behaviour. */
+            ruledPlacements?: string[];
         };
         OffersSearchResponse: {
             success: boolean;
@@ -4735,6 +5293,10 @@ export interface components {
                 heroImageUrl?: string | null;
                 /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
                 termsUrl?: string | null;
+                /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+                displayProperties?: {
+                    [key: string]: unknown;
+                };
                 /** Format: date-time */
                 createdAt: string;
                 /** Format: date-time */
@@ -4783,6 +5345,8 @@ export interface components {
                         title: string;
                         subtitle: string;
                         ctaButtonText?: string;
+                        /** @description Optional https image for this step. Absent: the step has none. */
+                        imageUrl?: string;
                     }[] | null;
                     /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
                     quickInstructions: string | null;
@@ -4849,11 +5413,41 @@ export interface components {
                 category?: string | null;
                 /** @description The gift-sheet group this campaign files under: "Watch & listen", "Money" or "Everyday". Derived from `category` by the server so a native chip strip shows what web tabs show without holding the taxonomy map. Always set: an absent, blank or unmapped category files under "Everyday", so every offer sits in some group. Whether a strip is worth drawing is the client's call, because only it knows which offers its sheet lists. /offers/search only: web-sdk holds its own copy of the map and groups `category` itself. */
                 categoryGroup?: string | null;
+                /** @description `category` in the response locale, for display only. Group and filter on `category`, which stays English. Null when `category` is null. /offers/search only. */
+                categoryDisplayName?: string | null;
+                /** @description `categoryGroup` in the response locale, for display only. Group on `categoryGroup`, which stays English. /offers/search only. */
+                categoryGroupDisplayName?: string | null;
                 /** @description Estimated time from the user tapping this offer to the reward being confirmed, from recent real conversions (on demo offers, from the demo advertiser's configured behavior instead). Half confirm within medianSeconds, 9 in 10 within p90Seconds. Not a guarantee: to show a wait, use p90Seconds. Null when there is no current estimate (too few recent conversions, data more than 7 days old, or an offer that does not confirm through the advertiser); say nothing about timing then. */
                 rewardConfirmationTime?: {
                     medianSeconds: number;
                     p90Seconds: number;
                 } | null;
+                /** @description Campaign claim-URL query parameters, keys verbatim (e.g. {"af_rid":"TRANSACTION_ID"}); equals the served creative's whenever one exists. Always pair it with the offer's destinationUrl, never with a creative's, and never build a claim URL from an absent or empty value. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                trackingParameters?: {
+                    [key: string]: unknown;
+                } | null;
+                /** @description Campaign call-to-action text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                ctaText?: string | null;
+                /** @description Campaign description, localized like creatives. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                description?: string | null;
+                /** @description Campaign step-by-step instructions, same shape as a creative's. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                instructions?: {
+                    title: string;
+                    subtitle: string;
+                    ctaButtonText?: string;
+                    /** @description Optional https image for this step. Absent: the step has none. */
+                    imageUrl?: string;
+                }[] | null;
+                /** @description Campaign one-line instructions. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                quickInstructions?: string | null;
+                /** @description Campaign logo override; null means use organization.logoUrl. Plain string, not format: uri, so one bad value cannot fail a whole Android decode. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                logoUrl?: string | null;
+                /** @description Campaign card title. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                title?: string | null;
+                /** @description Campaign card subtitle. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                subtitle?: string | null;
+                /** @description Campaign tooltip text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+                tooltipText?: string | null;
             }[];
             metadata: {
                 /** @description Total offers available */
@@ -4871,6 +5465,8 @@ export interface components {
             };
             /** @description Resolved locale served in this response (language-only, e.g. 'es'). Absent on pre-localization responses. */
             locale?: string;
+            /** @description Whether this user may still be granted the app's prize for a reward-for-trying Yes: true while the prizes granted to them in the last 24 hours (rolling) are under publisherRewardDailyLimit. Present only when the request sent publisherRewardDailyLimit. Offers this user already completed or said Yes to are never served, so this answers the daily limit only. Absent (an older backend, or no limit sent) means no promise. Not a grant: the self-report's granted answer is final. */
+            publisherRewardPromise?: boolean;
             error?: string | null;
         };
         Campaign: {
@@ -4938,6 +5534,10 @@ export interface components {
             heroImageUrl?: string | null;
             /** @description https link to the advertiser offer terms. Null or absent: render terms copy as plain text. */
             termsUrl?: string | null;
+            /** @description Display-only strings a variant renders by key, e.g. {"eligibilityNote":"New subscribers only"}. Values are strings; the type is free-form so one unexpected value cannot fail a client decode. Absent or empty: the variant draws none of those lines. */
+            displayProperties?: {
+                [key: string]: unknown;
+            };
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -4986,6 +5586,8 @@ export interface components {
                     title: string;
                     subtitle: string;
                     ctaButtonText?: string;
+                    /** @description Optional https image for this step. Absent: the step has none. */
+                    imageUrl?: string;
                 }[] | null;
                 /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
                 quickInstructions: string | null;
@@ -5052,11 +5654,41 @@ export interface components {
             category?: string | null;
             /** @description The gift-sheet group this campaign files under: "Watch & listen", "Money" or "Everyday". Derived from `category` by the server so a native chip strip shows what web tabs show without holding the taxonomy map. Always set: an absent, blank or unmapped category files under "Everyday", so every offer sits in some group. Whether a strip is worth drawing is the client's call, because only it knows which offers its sheet lists. /offers/search only: web-sdk holds its own copy of the map and groups `category` itself. */
             categoryGroup?: string | null;
+            /** @description `category` in the response locale, for display only. Group and filter on `category`, which stays English. Null when `category` is null. /offers/search only. */
+            categoryDisplayName?: string | null;
+            /** @description `categoryGroup` in the response locale, for display only. Group on `categoryGroup`, which stays English. /offers/search only. */
+            categoryGroupDisplayName?: string | null;
             /** @description Estimated time from the user tapping this offer to the reward being confirmed, from recent real conversions (on demo offers, from the demo advertiser's configured behavior instead). Half confirm within medianSeconds, 9 in 10 within p90Seconds. Not a guarantee: to show a wait, use p90Seconds. Null when there is no current estimate (too few recent conversions, data more than 7 days old, or an offer that does not confirm through the advertiser); say nothing about timing then. */
             rewardConfirmationTime?: {
                 medianSeconds: number;
                 p90Seconds: number;
             } | null;
+            /** @description Campaign claim-URL query parameters, keys verbatim (e.g. {"af_rid":"TRANSACTION_ID"}); equals the served creative's whenever one exists. Always pair it with the offer's destinationUrl, never with a creative's, and never build a claim URL from an absent or empty value. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            trackingParameters?: {
+                [key: string]: unknown;
+            } | null;
+            /** @description Campaign call-to-action text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            ctaText?: string | null;
+            /** @description Campaign description, localized like creatives. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            description?: string | null;
+            /** @description Campaign step-by-step instructions, same shape as a creative's. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            instructions?: {
+                title: string;
+                subtitle: string;
+                ctaButtonText?: string;
+                /** @description Optional https image for this step. Absent: the step has none. */
+                imageUrl?: string;
+            }[] | null;
+            /** @description Campaign one-line instructions. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            quickInstructions?: string | null;
+            /** @description Campaign logo override; null means use organization.logoUrl. Plain string, not format: uri, so one bad value cannot fail a whole Android decode. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            logoUrl?: string | null;
+            /** @description Campaign card title. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            title?: string | null;
+            /** @description Campaign card subtitle. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            subtitle?: string | null;
+            /** @description Campaign tooltip text. Absent unless the campaign offer fields flag is on; null means the campaign has none. */
+            tooltipText?: string | null;
         };
         Creative: {
             /** Format: uuid */
@@ -5088,6 +5720,8 @@ export interface components {
                 title: string;
                 subtitle: string;
                 ctaButtonText?: string;
+                /** @description Optional https image for this step. Absent: the step has none. */
+                imageUrl?: string;
             }[] | null;
             /** @description Short, actionable phrases (max 1-3) that guide users. Examples: "sign up, create registry", "add to cart" */
             quickInstructions: string | null;