@widgetic/api-sdk 1.0.29 → 1.0.31

package/dist/esm/apis/CompositionsApi.d.ts

@@ -10,12 +10,15 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CheckCompositionAccess200Response, Composition, CompositionEntriesDescription, CompositionEntriesReading, CreateComposition201Response, DuplicateComposition202Response, DuplicateCompositionRequest, GetAllCompositions200Response, GetCompositionContentSchema200Response, GetCompositionDesignSchema200Response, GetCompositionEmbedSchema200Response, GetCompositionPreview200Response, GetCompositionVersions200Response, GetCompositionsBatch200Response, GetCompositionsBatchRequest, NewComposition, SetDynamicContent200Response, SetDynamicContentRequest, UpdateComposition, UpdateCompositionStatusRequest, ValidateCompositionContent200Response } from '../models/index';
+import type { CheckCompositionAccess200Response, Composition, CompositionEntriesDescription, CompositionEntriesReading, CreateCompositionContentItemRequest, CreateCompositionFromWidget201Response, DeleteCompositionContentItem200Response, DuplicateComposition202Response, DuplicateCompositionRequest, GetAllCompositions200Response, GetCompositionContentSchema200Response, GetCompositionDesignSchema200Response, GetCompositionEmbedSchema200Response, GetCompositionPreview200Response, GetCompositionVersions200Response, GetCompositionsBatch200Response, GetCompositionsBatchRequest, NewComposition, SetCompositionDataSourceRequest, SetDynamicContent200Response, SetDynamicContentRequest, UpdateComposition, UpdateCompositionStatusRequest, ValidateCompositionContent200Response } from '../models/index';
 export interface CheckCompositionAccessRequest {
     id: string;
 }
-export interface CreateCompositionRequest {
-    newComposition: NewComposition;
+export interface CreateCompositionContentItem0Request {
+    id: string;
+    list: string;
+    createCompositionContentItemRequest: CreateCompositionContentItemRequest;
+    ifMatch?: string;
     idempotencyKey?: string;
 }
 export interface CreateCompositionDatabaseRecordRequest {
@@ -24,41 +27,59 @@ export interface CreateCompositionDatabaseRecordRequest {
     body: object;
     idempotencyKey?: string;
 }
-export interface DeleteCompositionRequest {
+export interface CreateComposition0Request {
+    newComposition: NewComposition;
+    idempotencyKey?: string;
+}
+export interface DeleteCompositionContentItem0Request {
     id: string;
+    list: string;
+    itemId: string;
+    ifMatch?: string;
+    idempotencyKey?: string;
+}
+export interface DeleteCompositionDataSource0Request {
+    id: string;
+    idempotencyKey?: string;
 }
 export interface DeleteCompositionDatabaseRecordRequest {
     id: string;
     table: string;
     recordId: string;
 }
-export interface DescribeCompositionEntriesRequest {
+export interface DeleteComposition0Request {
+    id: string;
+}
+export interface DescribeCompositionEntries0Request {
     id: string;
 }
-export interface DuplicateCompositionOperationRequest {
+export interface DuplicateComposition0Request {
     id: string;
     idempotencyKey?: string;
     duplicateCompositionRequest?: DuplicateCompositionRequest;
 }
-export interface GetAllCompositionsRequest {
+export interface GetAllCompositions0Request {
     page?: number;
     size?: number;
     sort?: string;
     widgetId?: string;
-    workspace?: GetAllCompositionsWorkspaceEnum;
+    workspace?: GetAllCompositions0WorkspaceEnum;
     projectFolder?: string;
-    status?: GetAllCompositionsStatusEnum;
+    status?: GetAllCompositions0StatusEnum;
     include?: string;
     managedUserId?: string;
     managedUserExternalId?: string;
 }
-export interface GetCompositionByIdRequest {
+export interface GetCompositionById0Request {
+    id: string;
+}
+export interface GetCompositionContentSchema0Request {
     id: string;
 }
-export interface GetCompositionContentRequest {
+export interface GetCompositionContent0Request {
     id: string;
 }
-export interface GetCompositionContentSchemaRequest {
+export interface GetCompositionDataSource0Request {
     id: string;
 }
 export interface GetCompositionDatabaseRecordRequest {
@@ -70,16 +91,16 @@ export interface GetCompositionDatabaseRecordsRequest {
     id: string;
     table: string;
 }
-export interface GetCompositionDesignRequest {
+export interface GetCompositionDesignSchema0Request {
     id: string;
 }
-export interface GetCompositionDesignSchemaRequest {
+export interface GetCompositionDesign0Request {
     id: string;
 }
-export interface GetCompositionEmbedSchemaRequest {
+export interface GetCompositionEmbedSchema0Request {
     id: string;
 }
-export interface GetCompositionEmbedSettingsRequest {
+export interface GetCompositionEmbedSettings0Request {
     id: string;
 }
 export interface GetCompositionPreviewRequest {
@@ -91,20 +112,41 @@ export interface GetCompositionVersionsRequest {
 export interface GetCompositionsBatchOperationRequest {
     getCompositionsBatchRequest: GetCompositionsBatchRequest;
 }
-export interface ReadCompositionEntriesRequest {
+export interface PatchCompositionContentItem0Request {
+    id: string;
+    list: string;
+    itemId: string;
+    requestBody: {
+        [key: string]: any;
+    };
+    ifMatch?: string;
+    idempotencyKey?: string;
+}
+export interface ReadCompositionEntries0Request {
     id: string;
     table: string;
     groupBy?: string;
     rows?: number;
+    aggregate?: string;
+    column?: string;
+    since?: Date;
+    until?: Date;
+    context?: {
+        [key: string]: string;
+    };
+    filter?: {
+        [key: string]: string;
+    };
 }
-export interface SetDynamicContentOperationRequest {
+export interface SetCompositionDataSource0Request {
     id: string;
-    setDynamicContentRequest: SetDynamicContentRequest;
+    setCompositionDataSourceRequest: SetCompositionDataSourceRequest;
     idempotencyKey?: string;
 }
-export interface UpdateCompositionRequest {
+export interface SetDynamicContent0Request {
     id: string;
-    updateComposition: UpdateComposition;
+    setDynamicContentRequest: SetDynamicContentRequest;
+    ifMatch?: string;
     idempotencyKey?: string;
 }
 export interface UpdateCompositionDatabaseRecordRequest {
@@ -119,6 +161,11 @@ export interface UpdateCompositionStatusOperationRequest {
     updateCompositionStatusRequest: UpdateCompositionStatusRequest;
     idempotencyKey?: string;
 }
+export interface UpdateComposition0Request {
+    id: string;
+    updateComposition: UpdateComposition;
+    idempotencyKey?: string;
+}
 export interface ValidateCompositionContentRequest {
     id: string;
     body: object;
@@ -139,15 +186,15 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      */
     checkCompositionAccess(requestParameters: CheckCompositionAccessRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CheckCompositionAccess200Response>;
     /**
-     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
-     * Create Composition
+     * Creates one item in a widget content list without replacing the whole list. Item field keys are widget data (camelCase or snake_case are kept as sent). Partners use this to keep galleries in sync.
+     * Add a content list item
      */
-    createCompositionRaw(requestParameters: CreateCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateComposition201Response>>;
+    createCompositionContentItemRaw(requestParameters: CreateCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
-     * Create Composition
+     * Creates one item in a widget content list without replacing the whole list. Item field keys are widget data (camelCase or snake_case are kept as sent). Partners use this to keep galleries in sync.
+     * Add a content list item
      */
-    createComposition(requestParameters: CreateCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateComposition201Response>;
+    createCompositionContentItem(requestParameters: CreateCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Creates a new record in a table in the composition\'s database.
      * Create Record In Composition Database
@@ -159,15 +206,31 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      */
     createCompositionDatabaseRecord(requestParameters: CreateCompositionDatabaseRecordRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Deletes a specific composition.
-     * Delete Composition
+     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create Composition
      */
-    deleteCompositionRaw(requestParameters: DeleteCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    createCompositionRaw(requestParameters: CreateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateCompositionFromWidget201Response>>;
     /**
-     * Deletes a specific composition.
-     * Delete Composition
+     * Creates a new composition.  To make the composition for one of your managed users, send `managedUserId` or `managedUserExternalId`. The composition stays in your account and is yours to edit; the tag lets you list one user\'s compositions with `getAllCompositions`. The managed user must be yours and active: one that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`. The tag is set here and does not change afterwards. A copy made with `duplicateComposition` keeps the tag of the original.  An editor session with the `creator` surface may call this to start a composition of a widget it built: it sends only `name`, `widgetId` (a widget made for the session\'s managed user) and `content`, and the composition is always made for that managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create Composition
+     */
+    createComposition(requestParameters: CreateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateCompositionFromWidget201Response>;
+    /**
+     * Delete a content list item
+     */
+    deleteCompositionContentItemRaw(requestParameters: DeleteCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeleteCompositionContentItem200Response>>;
+    /**
+     * Delete a content list item
      */
-    deleteComposition(requestParameters: DeleteCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    deleteCompositionContentItem(requestParameters: DeleteCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeleteCompositionContentItem200Response>;
+    /**
+     * Remove the composition data source binding
+     */
+    deleteCompositionDataSourceRaw(requestParameters: DeleteCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Remove the composition data source binding
+     */
+    deleteCompositionDataSource(requestParameters: DeleteCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Deletes a specific record from a table in the composition\'s database.
      * Delete Record From Composition Database
@@ -178,66 +241,84 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      * Delete Record From Composition Database
      */
     deleteCompositionDatabaseRecord(requestParameters: DeleteCompositionDatabaseRecordRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Deletes a specific composition.
+     * Delete Composition
+     */
+    deleteCompositionRaw(requestParameters: DeleteComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Deletes a specific composition.
+     * Delete Composition
+     */
+    deleteComposition(requestParameters: DeleteComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Names the tables a composition\'s widget keeps entries in (the votes, ratings, answers or sign-ups its visitors left), their columns, and how many entries each holds. Call it first to learn the table and column names that `readCompositionEntries` takes.  A widget that only shows content keeps nothing of its own: the answer is `hasData: false` with no tables, and that is not an error. A table that could not be counted has `rows: null`, which is not zero.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Describe What a Composition Keeps
      */
-    describeCompositionEntriesRaw(requestParameters: DescribeCompositionEntriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompositionEntriesDescription>>;
+    describeCompositionEntriesRaw(requestParameters: DescribeCompositionEntries0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompositionEntriesDescription>>;
     /**
      * Names the tables a composition\'s widget keeps entries in (the votes, ratings, answers or sign-ups its visitors left), their columns, and how many entries each holds. Call it first to learn the table and column names that `readCompositionEntries` takes.  A widget that only shows content keeps nothing of its own: the answer is `hasData: false` with no tables, and that is not an error. A table that could not be counted has `rows: null`, which is not zero.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Describe What a Composition Keeps
      */
-    describeCompositionEntries(requestParameters: DescribeCompositionEntriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompositionEntriesDescription>;
+    describeCompositionEntries(requestParameters: DescribeCompositionEntries0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompositionEntriesDescription>;
     /**
      * Creates a duplicate of an existing composition for the authenticated user.  The duplicate is made after the answer: the call returns `202` with an `operationId`. Ask `GET /operations/{id}` for that operation until its `status` is `completed`; the new composition is named in `metadata.newCompositionId`. A problem with the duplicate\'s database (for example, one that could not be copied) is listed in `metadata.warnings`, which is absent when there is none.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one duplicate is made, not two.
      * Duplicate Composition
      */
-    duplicateCompositionRaw(requestParameters: DuplicateCompositionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DuplicateComposition202Response>>;
+    duplicateCompositionRaw(requestParameters: DuplicateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DuplicateComposition202Response>>;
     /**
      * Creates a duplicate of an existing composition for the authenticated user.  The duplicate is made after the answer: the call returns `202` with an `operationId`. Ask `GET /operations/{id}` for that operation until its `status` is `completed`; the new composition is named in `metadata.newCompositionId`. A problem with the duplicate\'s database (for example, one that could not be copied) is listed in `metadata.warnings`, which is absent when there is none.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one duplicate is made, not two.
      * Duplicate Composition
      */
-    duplicateComposition(requestParameters: DuplicateCompositionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DuplicateComposition202Response>;
+    duplicateComposition(requestParameters: DuplicateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DuplicateComposition202Response>;
     /**
      * Retrieves all compositions with pagination support.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the compositions made for that managed user. The compositions of your other managed users, and your own, are left out. It combines with the other filters and with paging. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.  An editor session with the `creator` surface may call this to list the compositions of ONE widget it built: it must send `widget_id`, and the answer holds only the compositions made for the session\'s managed user.
      * Get All Compositions
      */
-    getAllCompositionsRaw(requestParameters: GetAllCompositionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAllCompositions200Response>>;
+    getAllCompositionsRaw(requestParameters: GetAllCompositions0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAllCompositions200Response>>;
     /**
      * Retrieves all compositions with pagination support.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the compositions made for that managed user. The compositions of your other managed users, and your own, are left out. It combines with the other filters and with paging. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.  An editor session with the `creator` surface may call this to list the compositions of ONE widget it built: it must send `widget_id`, and the answer holds only the compositions made for the session\'s managed user.
      * Get All Compositions
      */
-    getAllCompositions(requestParameters?: GetAllCompositionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAllCompositions200Response>;
+    getAllCompositions(requestParameters?: GetAllCompositions0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAllCompositions200Response>;
     /**
      * Retrieves a specific composition by its ID.
      * Get Composition
      */
-    getCompositionByIdRaw(requestParameters: GetCompositionByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateComposition201Response>>;
+    getCompositionByIdRaw(requestParameters: GetCompositionById0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateCompositionFromWidget201Response>>;
     /**
      * Retrieves a specific composition by its ID.
      * Get Composition
      */
-    getCompositionById(requestParameters: GetCompositionByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateComposition201Response>;
+    getCompositionById(requestParameters: GetCompositionById0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateCompositionFromWidget201Response>;
+    /**
+     * Retrieves the content schema for a composition based on its widget type
+     * Get Content Schema
+     */
+    getCompositionContentSchemaRaw(requestParameters: GetCompositionContentSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionContentSchema200Response>>;
+    /**
+     * Retrieves the content schema for a composition based on its widget type
+     * Get Content Schema
+     */
+    getCompositionContentSchema(requestParameters: GetCompositionContentSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionContentSchema200Response>;
     /**
      * Retrieves the current content of a composition
      * Get Current Content
      */
-    getCompositionContentRaw(requestParameters: GetCompositionContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
+    getCompositionContentRaw(requestParameters: GetCompositionContent0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
     /**
      * Retrieves the current content of a composition
      * Get Current Content
      */
-    getCompositionContent(requestParameters: GetCompositionContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
+    getCompositionContent(requestParameters: GetCompositionContent0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
     /**
-     * Retrieves the content schema for a composition based on its widget type
-     * Get Content Schema
+     * Read the composition data source binding
      */
-    getCompositionContentSchemaRaw(requestParameters: GetCompositionContentSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionContentSchema200Response>>;
+    getCompositionDataSourceRaw(requestParameters: GetCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Retrieves the content schema for a composition based on its widget type
-     * Get Content Schema
+     * Read the composition data source binding
      */
-    getCompositionContentSchema(requestParameters: GetCompositionContentSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionContentSchema200Response>;
+    getCompositionDataSource(requestParameters: GetCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Retrieves a specific record from a table in the composition\'s database.
      * Get Record From Composition Database
@@ -258,46 +339,46 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      * Get All Records From Composition Database Table
      */
     getCompositionDatabaseRecords(requestParameters: GetCompositionDatabaseRecordsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
-    /**
-     * Retrieves only the design field from a composition.
-     * Get Composition Design
-     */
-    getCompositionDesignRaw(requestParameters: GetCompositionDesignRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
-    /**
-     * Retrieves only the design field from a composition.
-     * Get Composition Design
-     */
-    getCompositionDesign(requestParameters: GetCompositionDesignRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
     /**
      * Retrieves the design schema for a composition based on its widget type
      * Get Design Schema
      */
-    getCompositionDesignSchemaRaw(requestParameters: GetCompositionDesignSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionDesignSchema200Response>>;
+    getCompositionDesignSchemaRaw(requestParameters: GetCompositionDesignSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionDesignSchema200Response>>;
     /**
      * Retrieves the design schema for a composition based on its widget type
      * Get Design Schema
      */
-    getCompositionDesignSchema(requestParameters: GetCompositionDesignSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionDesignSchema200Response>;
+    getCompositionDesignSchema(requestParameters: GetCompositionDesignSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionDesignSchema200Response>;
+    /**
+     * Retrieves only the design field from a composition.
+     * Get Composition Design
+     */
+    getCompositionDesignRaw(requestParameters: GetCompositionDesign0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
+    /**
+     * Retrieves only the design field from a composition.
+     * Get Composition Design
+     */
+    getCompositionDesign(requestParameters: GetCompositionDesign0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
     /**
      * Retrieves the definition of the composition\'s Embed tab: which settings exist, what each one holds, what it defaults to, and when its control is shown. It is the third tab beside `schema/content` and `schema/design`, in the same format (`componentGroups` → `components` → `propertyGroups` → `properties`, each property with a `type`, a `defaultValue` and an `inputController`), so a client that draws those two tabs draws this one with the same code.  The schema is the same for every composition (it is the one Widgetic\'s own Embed Editor draws). The composition id decides who may ask: the caller must be able to read the composition.  Reading and saving the values: - `GET /compositions/{id}/embed-settings` returns what the composition saved. A composition whose Embed tab   was never saved has nothing to return; seed the form from `defaults`, which holds the `defaultValue` of   every setting that declares one. - `PUT /compositions/{id}` with `embedSettings` saves them. The gateway stores `embedSettings` as given and   does not check it against this schema; the schema is how a client knows what to put there.  A property\'s `visibilityCondition` says when its control is shown: `condition` is a comparison of the current values of the properties named in `dependsOn` (`useIframe === false`, `embedTarget === \'mixed\' && keepDimensions === false`). While it is false the Embed Editor does not show the control.  A colour picker with `showOpacityControls` saves its opacity next to the colour, under the key `<name>_opacity` as a number from 0 to 1 (`overlayBackgroundColor` → `overlayBackgroundColor_opacity`). Its `defaultTransparency` is a percentage and the saved value a fraction (50 → 0.5).
      * Get Embed Schema
      */
-    getCompositionEmbedSchemaRaw(requestParameters: GetCompositionEmbedSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionEmbedSchema200Response>>;
+    getCompositionEmbedSchemaRaw(requestParameters: GetCompositionEmbedSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetCompositionEmbedSchema200Response>>;
     /**
      * Retrieves the definition of the composition\'s Embed tab: which settings exist, what each one holds, what it defaults to, and when its control is shown. It is the third tab beside `schema/content` and `schema/design`, in the same format (`componentGroups` → `components` → `propertyGroups` → `properties`, each property with a `type`, a `defaultValue` and an `inputController`), so a client that draws those two tabs draws this one with the same code.  The schema is the same for every composition (it is the one Widgetic\'s own Embed Editor draws). The composition id decides who may ask: the caller must be able to read the composition.  Reading and saving the values: - `GET /compositions/{id}/embed-settings` returns what the composition saved. A composition whose Embed tab   was never saved has nothing to return; seed the form from `defaults`, which holds the `defaultValue` of   every setting that declares one. - `PUT /compositions/{id}` with `embedSettings` saves them. The gateway stores `embedSettings` as given and   does not check it against this schema; the schema is how a client knows what to put there.  A property\'s `visibilityCondition` says when its control is shown: `condition` is a comparison of the current values of the properties named in `dependsOn` (`useIframe === false`, `embedTarget === \'mixed\' && keepDimensions === false`). While it is false the Embed Editor does not show the control.  A colour picker with `showOpacityControls` saves its opacity next to the colour, under the key `<name>_opacity` as a number from 0 to 1 (`overlayBackgroundColor` → `overlayBackgroundColor_opacity`). Its `defaultTransparency` is a percentage and the saved value a fraction (50 → 0.5).
      * Get Embed Schema
      */
-    getCompositionEmbedSchema(requestParameters: GetCompositionEmbedSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionEmbedSchema200Response>;
+    getCompositionEmbedSchema(requestParameters: GetCompositionEmbedSchema0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionEmbedSchema200Response>;
     /**
      * Retrieves only the embedSettings field from a composition.
      * Get Composition Embed Settings
      */
-    getCompositionEmbedSettingsRaw(requestParameters: GetCompositionEmbedSettingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
+    getCompositionEmbedSettingsRaw(requestParameters: GetCompositionEmbedSettings0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<object>>;
     /**
      * Retrieves only the embedSettings field from a composition.
      * Get Composition Embed Settings
      */
-    getCompositionEmbedSettings(requestParameters: GetCompositionEmbedSettingsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
+    getCompositionEmbedSettings(requestParameters: GetCompositionEmbedSettings0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<object>;
     /**
      * Returns the address of the page an editor shows the composition in: the page of the widget\'s published version on the CDN, with the widget and version it is. Load it in a frame, then send the frame what to show (the content, design and embed settings you read from the composition, and every change the user makes) with `postMessage`: `{ type: \'widgetic:update\', design }`, `{ type: \'widgetic:update\', content }` or `{ type: \'widgetic:update\', contentItems }`.  The version is the one embeds show, so the editor previews what a visitor gets. The address does not carry the composition id: an embed uses the id to fetch the saved composition itself, while an editor sends the current state (unsaved changes included).  A widget that has never been published has no page to show: the answer is 409 `WIDGET_NOT_PUBLISHED`.
      * Get Composition Preview
@@ -328,36 +409,44 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      * Get Compositions Batch
      */
     getCompositionsBatch(requestParameters: GetCompositionsBatchOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetCompositionsBatch200Response>;
+    /**
+     * Update a content list item
+     */
+    patchCompositionContentItemRaw(requestParameters: PatchCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Update a content list item
+     */
+    patchCompositionContentItem(requestParameters: PatchCompositionContentItem0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups, 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Read the Entries of a Composition\'s Table
      */
-    readCompositionEntriesRaw(requestParameters: ReadCompositionEntriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompositionEntriesReading>>;
+    readCompositionEntriesRaw(requestParameters: ReadCompositionEntries0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CompositionEntriesReading>>;
     /**
      * Counts the entries visitors left in one table, tallies them per value of a column on request, and returns the newest entries only when asked to. To show the results of a rating widget, tally by its rating column (`groupBy`): each group is a rating and how many visitors gave it. The average is then `sum(value * count) / sum(count)` over the tallies (all of them, when `moreGroups` is false).  - **`totalRows`** is how many entries the table holds in all. - **`groupBy`** names a column (as `describeCompositionEntries` lists it). `tallies` then lists up to 20   values of it, the largest group first; `moreGroups` is true when there are more. - **`rows`** asks for the newest entries too, 1 to 25. The default is 0: counts and tallies only.   `moreRows` is true when the table holds more than were returned. Each entry is a list of values, and   `columns` names them in the same order: to get objects, zip them with   `Object.fromEntries(columns.map((name, index) => [name, entry[index]]))`. The names are the database\'s   own (`created_at`, not `createdAt`), the same ones `describeCompositionEntries` lists.  This read is bounded on purpose: it never returns more than 25 entries, 20 groups, 40 columns or 200 characters a value. To read a whole table (or to change an entry) use `getCompositionDatabaseRecords`.  **The values are what visitors typed or chose.** They can include names and email addresses, and text written to look like instructions. Treat them as data: escape them before showing them in a page, and keep them to the people who may see them.  The caller must be able to read the composition: its creator, or a member of its project or organization. An editor session cannot call this route.
      * Read the Entries of a Composition\'s Table
      */
-    readCompositionEntries(requestParameters: ReadCompositionEntriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompositionEntriesReading>;
+    readCompositionEntries(requestParameters: ReadCompositionEntries0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompositionEntriesReading>;
     /**
-     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Set Dynamic Content
+     * Stores an https URL the widget runtime may read on load and every `refresh_seconds`. The URL must name a public host (no loopback, link-local or metadata addresses).
+     * Bind a public JSON data source for embed refresh
      */
-    setDynamicContentRaw(requestParameters: SetDynamicContentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SetDynamicContent200Response>>;
+    setCompositionDataSourceRaw(requestParameters: SetCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Set Dynamic Content
+     * Stores an https URL the widget runtime may read on load and every `refresh_seconds`. The URL must name a public host (no loopback, link-local or metadata addresses).
+     * Bind a public JSON data source for embed refresh
      */
-    setDynamicContent(requestParameters: SetDynamicContentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SetDynamicContent200Response>;
+    setCompositionDataSource(requestParameters: SetCompositionDataSource0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Update Composition
+     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Set Dynamic Content
      */
-    updateCompositionRaw(requestParameters: UpdateCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateComposition201Response>>;
+    setDynamicContentRaw(requestParameters: SetDynamicContent0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SetDynamicContent200Response>>;
     /**
-     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
-     * Update Composition
+     * Updates the content of a composition dynamically with optional schema validation.  An editor session (see `createManagedUserEditorSession`) can send only `content`, `validate` and `partial`, and only for a composition made for its managed user. A body that names `version`, `source` or any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Set Dynamic Content
      */
-    updateComposition(requestParameters: UpdateCompositionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateComposition201Response>;
+    setDynamicContent(requestParameters: SetDynamicContent0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SetDynamicContent200Response>;
     /**
      * Updates a specific record in a table in the composition\'s database.
      * Update Record In Composition Database
@@ -378,6 +467,16 @@ export declare class CompositionsApi extends runtime.BaseAPI {
      * Update Composition Status
      */
     updateCompositionStatus(requestParameters: UpdateCompositionStatusOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Composition>;
+    /**
+     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Update Composition
+     */
+    updateCompositionRaw(requestParameters: UpdateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateCompositionFromWidget201Response>>;
+    /**
+     * Updates a specific composition.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry.  An editor session (see `createManagedUserEditorSession`) can send only `name`, `content`, `design` and `embedSettings`, and only for a composition made for its managed user. A body that names any other field is refused with `403` and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.
+     * Update Composition
+     */
+    updateComposition(requestParameters: UpdateComposition0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateCompositionFromWidget201Response>;
     /**
      * Validates content against the composition\'s widget schema without updating
      * Validate Content
@@ -392,17 +491,17 @@ export declare class CompositionsApi extends runtime.BaseAPI {
 /**
  * @export
  */
-export declare const GetAllCompositionsWorkspaceEnum: {
+export declare const GetAllCompositions0WorkspaceEnum: {
     readonly True: "true";
     readonly False: "false";
 };
-export type GetAllCompositionsWorkspaceEnum = typeof GetAllCompositionsWorkspaceEnum[keyof typeof GetAllCompositionsWorkspaceEnum];
+export type GetAllCompositions0WorkspaceEnum = typeof GetAllCompositions0WorkspaceEnum[keyof typeof GetAllCompositions0WorkspaceEnum];
 /**
  * @export
  */
-export declare const GetAllCompositionsStatusEnum: {
+export declare const GetAllCompositions0StatusEnum: {
     readonly Draft: "draft";
     readonly Published: "published";
     readonly Archived: "archived";
 };
-export type GetAllCompositionsStatusEnum = typeof GetAllCompositionsStatusEnum[keyof typeof GetAllCompositionsStatusEnum];
+export type GetAllCompositions0StatusEnum = typeof GetAllCompositions0StatusEnum[keyof typeof GetAllCompositions0StatusEnum];