@kard-financial/sdk 28.2.0 → 29.0.0

package/dist/esm/api/resources/organizations/resources/placements/client/Client.mjs

@@ -20,7 +20,7 @@ export class PlacementsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Create a placement for the organization. Use type "placementMainPage" for main-page placements (requires name and availableSlots) or "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1).
+     * Create a placement for the organization. Use type "placement" for standard placements (requires name and availableSlots), "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1), "placementEmail" for email placements (requires name, cadence, and availableSlots), "placementBatchActivation" for batch-activation placements (requires name, refreshInterval, and slots), or "placementGroup" for group placements (requires name and slots).
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {KardApi.organizations.CreatePlacementRequestBody} request
@@ -35,7 +35,7 @@ export class PlacementsClient {
      * @example
      *     await client.organizations.placements.create("org-123", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "Homepage Banner",
      *                 availableSlots: 5
@@ -56,6 +56,53 @@ export class PlacementsClient {
      *             }
      *         }
      *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementEmail",
+     *             attributes: {
+     *                 name: "Weekly Deals Email",
+     *                 availableSlots: 10,
+     *                 cadence: {
+     *                     frequency: "WEEKLY",
+     *                     timeOfDay: "10:00",
+     *                     dayOfWeek: "MON"
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementBatchActivation",
+     *             attributes: {
+     *                 name: "Weekly Cohort",
+     *                 refreshInterval: "P7D",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Featured deals refreshed each week"
+     *                     }]
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementGroup",
+     *             attributes: {
+     *                 name: "Seasonal Collection",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Seasonal picks"
+     *                     }]
+     *             }
+     *         }
+     *     })
      */
     create(organizationId, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(organizationId, request, requestOptions));
@@ -248,7 +295,7 @@ export class PlacementsClient {
         });
     }
     /**
-     * Replace a placement. All fields must be provided. Use type "placementMainPage" or "placementPushNotification" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
+     * Replace a placement. All fields must be provided. Use type "placement", "placementPushNotification", "placementEmail", "placementBatchActivation", or "placementGroup" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {string} placementId - Unique identifier of the placement (UUID v7)
@@ -264,7 +311,7 @@ export class PlacementsClient {
      * @example
      *     await client.organizations.placements.update("organizationId", "placementId", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "name",
      *                 availableSlots: 1

package/dist/esm/api/resources/organizations/resources/placements/client/requests/GetPlacementRequest.d.mts

@@ -3,6 +3,6 @@
  *     {}
  */
 export interface GetPlacementRequest {
-    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
+    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation or group placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
     include?: string;
 }

package/dist/esm/api/resources/organizations/resources/placements/client/requests/ListPlacementsRequest.d.mts

@@ -4,13 +4,13 @@ import type * as KardApi from "../../../../../../index.mjs";
  *     {}
  */
 export interface ListPlacementsRequest {
-    /** Filter by placement type (placementMainPage or placementPushNotification) */
+    /** Filter by placement type (placement, placementPushNotification, placementEmail, placementBatchActivation, or placementGroup) */
     "filter[type]"?: KardApi.organizations.PlacementTypeFilter;
     /** Filter by exact placement name (unique within an organization per type) */
     "filter[name]"?: string;
     /** Filter by the ID of the content strategy linked to the placement */
     "filter[contentStrategyId]"?: string;
-    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
+    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation or group placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
     include?: string;
     /** Cursor value for the next page of results */
     "page[after]"?: string;

package/dist/esm/api/resources/organizations/resources/placements/types/BatchActivationPlacementData.d.mts

@@ -7,5 +7,5 @@ export interface BatchActivationPlacementData {
     id: string;
     attributes: KardApi.organizations.BatchActivationPlacementAttributes;
     /** JSON:API relationships for the placement. Always present on a batch-activation placement; the `slots` to-many relationship lists the slot resource identifiers. */
-    relationships: KardApi.organizations.BatchActivationPlacementRelationships;
+    relationships: KardApi.organizations.SlottedPlacementRelationships;
 }

package/dist/esm/api/resources/organizations/resources/placements/types/Cadence.d.mts

@@ -1,6 +1,6 @@
 import type * as KardApi from "../../../../../index.mjs";
 /**
- * Cadence schedule for push notification placements
+ * Cadence schedule for push notification and email placements
  */
 export interface Cadence {
     /** Delivery frequency */

package/dist/esm/api/resources/organizations/resources/placements/types/CadenceFrequency.d.mts

@@ -1,4 +1,4 @@
-/** How often a push notification placement delivers */
+/** How often a push notification or email placement delivers */
 export declare const CadenceFrequency: {
     readonly Daily: "DAILY";
     readonly Weekly: "WEEKLY";

package/dist/esm/api/resources/organizations/resources/placements/types/CadenceFrequency.mjs

@@ -1,5 +1,5 @@
 // This file was auto-generated by Fern from our API Definition.
-/** How often a push notification placement delivers */
+/** How often a push notification or email placement delivers */
 export const CadenceFrequency = {
     Daily: "DAILY",
     Weekly: "WEEKLY",

package/dist/esm/api/resources/organizations/resources/placements/types/CreateBatchActivationSlot.d.mts

@@ -1,5 +1,5 @@
 /**
- * A slot in a batch-activation placement at creation time
+ * A slot in a batch-activation or group placement at creation time
  */
 export interface CreateBatchActivationSlot {
     /** ID of another placement that fills this slot. The referenced placement provides both the content strategy and the limit on the number of offers available to the slot. */

package/dist/esm/api/resources/organizations/resources/placements/types/CreateEmailAttributes.d.mts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for creating an email placement
+ *
+ * @example
+ *     {
+ *         name: "Weekly Deals Email",
+ *         availableSlots: 10,
+ *         cadence: {
+ *             frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *             timeOfDay: "10:00",
+ *             dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *         }
+ *     }
+ */
+export interface CreateEmailAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Number of available slots (minimum 1) */
+    availableSlots: number;
+    /** Delivery cadence for the email */
+    cadence: KardApi.organizations.Cadence;
+    /** ID of the content strategy to link this placement to */
+    contentStrategyId?: string | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateEmailPlacementData.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Data for creating an email placement
+ */
+export interface CreateEmailPlacementData {
+    /** Email placement attributes for creation */
+    attributes: KardApi.organizations.CreateEmailAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupAttributes.d.mts

@@ -0,0 +1,20 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for creating a group placement
+ *
+ * @example
+ *     {
+ *         name: "Seasonal Collection",
+ *         slots: [{
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Seasonal picks"
+ *             }]
+ *     }
+ */
+export interface CreateGroupAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Slots that make up the group */
+    slots: KardApi.organizations.CreateBatchActivationSlot[];
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupPlacementData.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Data for creating a group placement
+ */
+export interface CreateGroupPlacementData {
+    /** Group placement attributes for creation */
+    attributes: KardApi.organizations.CreateGroupAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreatePlacementDataUnion.d.mts

@@ -2,15 +2,21 @@ import type * as KardApi from "../../../../../index.mjs";
 /**
  * Discriminated union for creating a placement
  */
-export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.PlacementMainPage | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.CreatePlacementDataUnion.PlacementBatchActivation;
+export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.Placement | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.CreatePlacementDataUnion.PlacementEmail | KardApi.organizations.CreatePlacementDataUnion.PlacementBatchActivation | KardApi.organizations.CreatePlacementDataUnion.PlacementGroup;
 export declare namespace CreatePlacementDataUnion {
-    interface PlacementMainPage extends KardApi.organizations.CreateMainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.CreateStandardPlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.CreatePushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.CreateEmailPlacementData {
+        type: "placementEmail";
+    }
     interface PlacementBatchActivation extends KardApi.organizations.CreateBatchActivationPlacementData {
         type: "placementBatchActivation";
     }
+    interface PlacementGroup extends KardApi.organizations.CreateGroupPlacementData {
+        type: "placementGroup";
+    }
 }

package/dist/esm/api/resources/organizations/resources/placements/types/CreatePlacementRequestBody.d.mts

@@ -5,7 +5,7 @@ import type * as KardApi from "../../../../../index.mjs";
  * @example
  *     {
  *         data: {
- *             type: "placementMainPage",
+ *             type: "placement",
  *             attributes: {
  *                 name: "Homepage Banner",
  *                 availableSlots: 5
@@ -26,6 +26,53 @@ import type * as KardApi from "../../../../../index.mjs";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementEmail",
+ *             attributes: {
+ *                 name: "Weekly Deals Email",
+ *                 availableSlots: 10,
+ *                 cadence: {
+ *                     frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *                     timeOfDay: "10:00",
+ *                     dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementBatchActivation",
+ *             attributes: {
+ *                 name: "Weekly Cohort",
+ *                 refreshInterval: "P7D",
+ *                 slots: [{
+ *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                         alias: "primary",
+ *                         shortDescription: "Featured deals refreshed each week"
+ *                     }]
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementGroup",
+ *             attributes: {
+ *                 name: "Seasonal Collection",
+ *                 slots: [{
+ *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                         alias: "primary",
+ *                         shortDescription: "Seasonal picks"
+ *                     }]
+ *             }
+ *         }
+ *     }
  */
 export interface CreatePlacementRequestBody {
     /** Placement data for creation */

package/dist/{cjs/api/resources/organizations/resources/placements/types/CreateMainPageAttributes.d.ts → esm/api/resources/organizations/resources/placements/types/CreateStandardAttributes.d.mts}

@@ -1,5 +1,5 @@
 /**
- * Attributes for creating a main-page placement
+ * Attributes for creating a standard placement
  *
  * @example
  *     {
@@ -7,7 +7,7 @@
  *         availableSlots: 5
  *     }
  */
-export interface CreateMainPageAttributes {
+export interface CreateStandardAttributes {
     /** Name of the placement */
     name: string;
     /** Number of available slots (minimum 1) */

package/dist/esm/api/resources/organizations/resources/placements/types/CreateStandardPlacementData.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Data for creating a standard placement
+ */
+export interface CreateStandardPlacementData {
+    /** Standard placement attributes for creation */
+    attributes: KardApi.organizations.CreateStandardAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/EmailPlacementAttributes.d.mts

@@ -0,0 +1,16 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for an email placement
+ */
+export interface EmailPlacementAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ID of the organization this placement belongs to */
+    organizationId: string;
+    /** Number of available slots */
+    availableSlots: number;
+    /** Delivery cadence for the email */
+    cadence: KardApi.organizations.Cadence;
+    /** ID of the content strategy linked to this placement, if any. Retained alongside `relationships.contentStrategy` for backward compatibility. */
+    contentStrategyId?: string | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/{MainPagePlacementData.d.mts → EmailPlacementData.d.mts}

@@ -1,11 +1,11 @@
 import type * as KardApi from "../../../../../index.mjs";
 /**
- * Main-page placement resource data
+ * Email placement resource data
  */
-export interface MainPagePlacementData {
+export interface EmailPlacementData {
     /** Unique identifier of the placement (UUID v7) */
     id: string;
-    attributes: KardApi.organizations.MainPagePlacementAttributes;
+    attributes: KardApi.organizations.EmailPlacementAttributes;
     /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
     relationships?: KardApi.organizations.PlacementRelationships | undefined;
 }

package/dist/esm/api/resources/organizations/resources/placements/types/EmailPlacementData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/GroupPlacementAttributes.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Attributes for a group placement. A group is configured like a batch-activation placement but has no refreshInterval. Slot detail is exposed via `relationships.slots` (resource identifiers) and the `batchActivationSlot` entries in `included`; request `?include=slots` (or a deeper path) to get the slot details.
+ */
+export interface GroupPlacementAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ID of the organization this placement belongs to */
+    organizationId: string;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/GroupPlacementAttributes.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/GroupPlacementData.d.mts

@@ -0,0 +1,11 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Group placement resource data
+ */
+export interface GroupPlacementData {
+    /** Unique identifier of the placement (UUID v7) */
+    id: string;
+    attributes: KardApi.organizations.GroupPlacementAttributes;
+    /** JSON:API relationships for the placement. Always present on a group placement; the `slots` to-many relationship lists the slot resource identifiers. */
+    relationships: KardApi.organizations.SlottedPlacementRelationships;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/GroupPlacementData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/IncludedResource.d.mts

@@ -2,7 +2,7 @@ import type * as KardApi from "../../../../../index.mjs";
 /**
  * Discriminated union of every resource type that can appear in the `included` array. The shape of each branch matches the corresponding primary-data resource (same attributes and relationships), keyed on the JSON:API `type` discriminant.
  */
-export type IncludedResource = KardApi.organizations.IncludedResource.ContentStrategy | KardApi.organizations.IncludedResource.BatchActivationSlot | KardApi.organizations.IncludedResource.PlacementMainPage | KardApi.organizations.IncludedResource.PlacementPushNotification;
+export type IncludedResource = KardApi.organizations.IncludedResource.ContentStrategy | KardApi.organizations.IncludedResource.BatchActivationSlot | KardApi.organizations.IncludedResource.Placement | KardApi.organizations.IncludedResource.PlacementPushNotification | KardApi.organizations.IncludedResource.PlacementEmail;
 export declare namespace IncludedResource {
     interface ContentStrategy extends KardApi.organizations.ContentStrategyInclusion {
         type: "contentStrategy";
@@ -10,10 +10,13 @@ export declare namespace IncludedResource {
     interface BatchActivationSlot extends KardApi.organizations.BatchActivationSlotInclusion {
         type: "batchActivationSlot";
     }
-    interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.PlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.EmailPlacementData {
+        type: "placementEmail";
+    }
 }

package/dist/{cjs/api/resources/organizations/resources/placements/types/MainPagePlacementAttributes.d.ts → esm/api/resources/organizations/resources/placements/types/PlacementAttributes.d.mts}

@@ -1,7 +1,7 @@
 /**
- * Attributes for a main-page placement
+ * Attributes for a standard placement
  */
-export interface MainPagePlacementAttributes {
+export interface PlacementAttributes {
     /** Name of the placement */
     name: string;
     /** ID of the organization this placement belongs to */

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementAttributes.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementData.d.mts

@@ -0,0 +1,11 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Standard placement resource data
+ */
+export interface PlacementData {
+    /** Unique identifier of the placement (UUID v7) */
+    id: string;
+    attributes: KardApi.organizations.PlacementAttributes;
+    /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
+    relationships?: KardApi.organizations.PlacementRelationships | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementFormatUnion.d.mts

@@ -4,7 +4,7 @@ import type * as KardApi from "../../../../../index.mjs";
  *
  * @example
  *     {
- *         type: "placementMainPage",
+ *         type: "placement",
  *         id: "01961e5a-b74c-7d42-8456-d3a1f2c90e71",
  *         attributes: {
  *             name: "Homepage Banner",
@@ -29,6 +29,22 @@ import type * as KardApi from "../../../../../index.mjs";
  *
  * @example
  *     {
+ *         type: "placementEmail",
+ *         id: "01961e5a-f37a-7b55-9d6a-2be8d1ac5f78",
+ *         attributes: {
+ *             name: "Weekly Deals Email",
+ *             organizationId: "org-123",
+ *             availableSlots: 10,
+ *             cadence: {
+ *                 frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *                 timeOfDay: "10:00",
+ *                 dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
  *         type: "placementBatchActivation",
  *         id: "01961e5a-d94e-7c22-ac3f-f8b5a7e92c45",
  *         attributes: {
@@ -45,16 +61,40 @@ import type * as KardApi from "../../../../../index.mjs";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         type: "placementGroup",
+ *         id: "01961e5a-a48b-7e66-8c7b-3cf9e2bd6a89",
+ *         attributes: {
+ *             name: "Seasonal Collection",
+ *             organizationId: "org-123"
+ *         },
+ *         relationships: {
+ *             slots: {
+ *                 data: [{
+ *                         type: "batchActivationSlot",
+ *                         id: "01961e5a-b59c-7f77-9d8c-4d0af3ce7b9a"
+ *                     }]
+ *             }
+ *         }
+ *     }
  */
-export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.PlacementMainPage | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification | KardApi.organizations.PlacementFormatUnion.PlacementBatchActivation;
+export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.Placement | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification | KardApi.organizations.PlacementFormatUnion.PlacementEmail | KardApi.organizations.PlacementFormatUnion.PlacementBatchActivation | KardApi.organizations.PlacementFormatUnion.PlacementGroup;
 export declare namespace PlacementFormatUnion {
-    interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.PlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.EmailPlacementData {
+        type: "placementEmail";
+    }
     interface PlacementBatchActivation extends KardApi.organizations.BatchActivationPlacementData {
         type: "placementBatchActivation";
     }
+    interface PlacementGroup extends KardApi.organizations.GroupPlacementData {
+        type: "placementGroup";
+    }
 }

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementListResponse.d.mts

@@ -5,7 +5,7 @@ import type * as KardApi from "../../../../../index.mjs";
 export interface PlacementListResponse {
     /** Array of placement resources */
     data: KardApi.organizations.PlacementFormatUnion[];
-    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placement`, `placementPushNotification`, `placementEmail`). */
     included?: KardApi.organizations.IncludedResource[] | undefined;
     links?: KardApi.Links | undefined;
     /** Pagination metadata */

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementResource.d.mts

@@ -5,6 +5,6 @@ import type * as KardApi from "../../../../../index.mjs";
 export interface PlacementResource {
     /** Placement resource */
     data: KardApi.organizations.PlacementFormatUnion;
-    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placement`, `placementPushNotification`, `placementEmail`). */
     included?: KardApi.organizations.IncludedResource[] | undefined;
 }

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementTypeFilter.d.mts

@@ -1,7 +1,9 @@
 /** Placement type discriminator used as a list filter */
 export declare const PlacementTypeFilter: {
-    readonly PlacementMainPage: "placementMainPage";
+    readonly Placement: "placement";
     readonly PlacementPushNotification: "placementPushNotification";
+    readonly PlacementEmail: "placementEmail";
     readonly PlacementBatchActivation: "placementBatchActivation";
+    readonly PlacementGroup: "placementGroup";
 };
 export type PlacementTypeFilter = (typeof PlacementTypeFilter)[keyof typeof PlacementTypeFilter];

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementTypeFilter.mjs

@@ -1,7 +1,9 @@
 // This file was auto-generated by Fern from our API Definition.
 /** Placement type discriminator used as a list filter */
 export const PlacementTypeFilter = {
-    PlacementMainPage: "placementMainPage",
+    Placement: "placement",
     PlacementPushNotification: "placementPushNotification",
+    PlacementEmail: "placementEmail",
     PlacementBatchActivation: "placementBatchActivation",
+    PlacementGroup: "placementGroup",
 };

package/dist/esm/api/resources/organizations/resources/placements/types/SlottedPlacementRelationships.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Relationship block for a batch-activation or group placement.
+ */
+export interface SlottedPlacementRelationships {
+    /** Resource identifiers for the slots that make up the placement. Each entry corresponds to a `batchActivationSlot` resource that appears in `included` when the request asks for `slots` (or any deeper path that implies it). */
+    slots: KardApi.organizations.ToManyRelationship;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/SlottedPlacementRelationships.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/UpdateBatchActivationSlot.d.mts

@@ -1,5 +1,5 @@
 /**
- * A slot in a batch-activation placement at update time
+ * A slot in a batch-activation or group placement at update time
  */
 export interface UpdateBatchActivationSlot {
     /** Existing slot identifier. Echo the value from a prior GET to keep the slot stable; omit to mint a fresh slot. If the placementId changes, the slotId is regenerated regardless of what was echoed. */

package/dist/esm/api/resources/organizations/resources/placements/types/UpdateEmailAttributes.d.mts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for updating an email placement. All fields are required.
+ *
+ * @example
+ *     {
+ *         name: "Updated Email",
+ *         availableSlots: 8,
+ *         cadence: {
+ *             frequency: KardApi.organizations.CadenceFrequency.Monthly,
+ *             timeOfDay: "08:00",
+ *             dayOfMonth: 1
+ *         }
+ *     }
+ */
+export interface UpdateEmailAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Number of available slots (minimum 1) */
+    availableSlots: number;
+    /** Delivery cadence for the email */
+    cadence: KardApi.organizations.Cadence;
+    /** ID of the content strategy to link this placement to. Omit to clear any existing link (PUT requires the full attribute set, so a missing value unlinks the placement). */
+    contentStrategyId?: string | undefined;
+}