@widgetic/api-sdk 1.0.30 → 1.0.32

package/dist/apis/UploadsApi.d.ts

@@ -10,19 +10,22 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { Upload, UploadLimits, UploadsGet200Response } from '../models/index';
-export interface UploadsGetRequest {
+import type { Upload, UploadLimits, UploadsGet200Response, UploadsIdDelete200Response } from '../models/index';
+export interface UploadsGet0Request {
     limit?: number;
     managedUserId?: string;
     managedUserExternalId?: string;
 }
-export interface UploadsIdGetRequest {
+export interface UploadsIdDelete0Request {
     id: string;
 }
-export interface UploadsPostRequest {
+export interface UploadsIdGet0Request {
+    id: string;
+}
+export interface UploadsPost0Request {
     file: Blob;
-    contextType?: UploadsPostContextTypeEnum;
-    source?: UploadsPostSourceEnum;
+    contextType?: UploadsPost0ContextTypeEnum;
+    source?: UploadsPost0SourceEnum;
     managedUserId?: string;
     managedUserExternalId?: string;
 }
@@ -37,22 +40,32 @@ export declare class UploadsApi extends runtime.BaseAPI {
      * The files the account has uploaded, newest first. Deleted files are not listed. Returns at most `limit` files and has no further pages: a client that needs more narrows the list instead, for example to one managed user\'s files with `managed_user_id` or `managed_user_external_id`.
      * List the account\'s uploads
      */
-    uploadsGetRaw(requestParameters: UploadsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UploadsGet200Response>>;
+    uploadsGetRaw(requestParameters: UploadsGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UploadsGet200Response>>;
     /**
      * The files the account has uploaded, newest first. Deleted files are not listed. Returns at most `limit` files and has no further pages: a client that needs more narrows the list instead, for example to one managed user\'s files with `managed_user_id` or `managed_user_external_id`.
      * List the account\'s uploads
      */
-    uploadsGet(requestParameters?: UploadsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UploadsGet200Response>;
+    uploadsGet(requestParameters?: UploadsGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UploadsGet200Response>;
+    /**
+     * Removes the stored file and the upload row. A file in Widgetic\'s own storage gives back the space it took from your storage allowance; a file in your own bucket is removed from your bucket. Deleting an upload that is already gone succeeds the same way as the first delete. An upload that belongs to another account is not found. If the storage cannot be reached the call fails and nothing is marked deleted, so it can be repeated.
+     * Delete an upload
+     */
+    uploadsIdDeleteRaw(requestParameters: UploadsIdDelete0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UploadsIdDelete200Response>>;
+    /**
+     * Removes the stored file and the upload row. A file in Widgetic\'s own storage gives back the space it took from your storage allowance; a file in your own bucket is removed from your bucket. Deleting an upload that is already gone succeeds the same way as the first delete. An upload that belongs to another account is not found. If the storage cannot be reached the call fails and nothing is marked deleted, so it can be repeated.
+     * Delete an upload
+     */
+    uploadsIdDelete(requestParameters: UploadsIdDelete0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UploadsIdDelete200Response>;
     /**
      * The details of one of the account\'s uploads. An upload that belongs to another account is not found.
      * Get an upload by id
      */
-    uploadsIdGetRaw(requestParameters: UploadsIdGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Upload>>;
+    uploadsIdGetRaw(requestParameters: UploadsIdGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Upload>>;
     /**
      * The details of one of the account\'s uploads. An upload that belongs to another account is not found.
      * Get an upload by id
      */
-    uploadsIdGet(requestParameters: UploadsIdGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Upload>;
+    uploadsIdGet(requestParameters: UploadsIdGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Upload>;
     /**
      * The size limit and the accepted file types of the upload endpoints. Read them from here rather than hard-coding thresholds: they are configuration and can change. The limits are the same for every account, whatever its plan: `multipart_max_bytes` for a file sent in one request (10 MB) and `tus_max_bytes` for a resumable upload (250 MB).
      * Upload size limits and accepted file types
@@ -67,12 +80,12 @@ export declare class UploadsApi extends runtime.BaseAPI {
      * Stores one file for the account and returns its public address. This is how a user\'s own images, video and PDFs reach a widget\'s content.  Send a `multipart/form-data` request with the file in the field named `file`. The file counts against the account\'s storage allowance, and a full allowance is refused with 413 and `QUOTA_STORAGE_EXCEEDED`. A file over the size limit is refused with 413 and `UPLOAD_TOO_LARGE`, and a type that is not accepted with 415 and `UPLOAD_UNSUPPORTED_TYPE`; `uploadsLimitsGet` lists the size limit and the accepted types.  To upload the file for one of your managed users, send `managed_user_id` (Widgetic\'s id for the user) or `managed_user_external_id` (your own identifier for the user), not both. The file stays in your account and counts against its allowance; the tag lets you list one user\'s files with `uploadsGet`. The managed user must be yours and active: one that is not yours, or does not exist, is refused with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`, before the file is stored. The tag is set here and does not change afterwards.  Called with an editor session (`createManagedUserEditorSession`), the file is always filed for the session\'s own managed user and is always media for widget content: naming another managed user is refused with 403 and `MANAGED_USER_SESSION_MISMATCH`, and `context_type`, `source`, `widget_id` and `conversation_id` are ignored. A full storage allowance is refused with the same 413 and `QUOTA_STORAGE_EXCEEDED`, but the message only says that it is not available right now (not how much is stored: that is the partner\'s business) and `error.details.limit` is `storage`.  An account that administers a partner with a storage destination (`setPartnerStorageDestination`) has its files stored in the partner\'s own bucket instead. Such a file takes none of the allowance, its `url` is served from the partner\'s public address, and its `storage_key` is the key in the partner\'s bucket. The file is never stored with Widgetic instead: when the destination cannot be used the upload is refused with 503 and `STORAGE_DESTINATION_UNAVAILABLE`, and when the partner\'s storage rejects the file with 502 and `STORAGE_DESTINATION_WRITE_FAILED`.  Partner storage is not optional. A partner\'s own uploads (with its API key) and the uploads of its customers\' editor sessions are kept in the partner\'s own storage or not at all, so a partner with no destination (or one that removed it after the session was made) has them refused with 409 and `PARTNER_STORAGE_REQUIRED`; they are never stored with Widgetic. An editor session\'s browser is only told that the feature is not available right now.
      * Upload a file
      */
-    uploadsPostRaw(requestParameters: UploadsPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Upload>>;
+    uploadsPostRaw(requestParameters: UploadsPost0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Upload>>;
     /**
      * Stores one file for the account and returns its public address. This is how a user\'s own images, video and PDFs reach a widget\'s content.  Send a `multipart/form-data` request with the file in the field named `file`. The file counts against the account\'s storage allowance, and a full allowance is refused with 413 and `QUOTA_STORAGE_EXCEEDED`. A file over the size limit is refused with 413 and `UPLOAD_TOO_LARGE`, and a type that is not accepted with 415 and `UPLOAD_UNSUPPORTED_TYPE`; `uploadsLimitsGet` lists the size limit and the accepted types.  To upload the file for one of your managed users, send `managed_user_id` (Widgetic\'s id for the user) or `managed_user_external_id` (your own identifier for the user), not both. The file stays in your account and counts against its allowance; the tag lets you list one user\'s files with `uploadsGet`. The managed user must be yours and active: one that is not yours, or does not exist, is refused with 404 and `MANAGED_USER_NOT_FOUND`, and one that is switched off with 409 and `MANAGED_USER_INACTIVE`, before the file is stored. The tag is set here and does not change afterwards.  Called with an editor session (`createManagedUserEditorSession`), the file is always filed for the session\'s own managed user and is always media for widget content: naming another managed user is refused with 403 and `MANAGED_USER_SESSION_MISMATCH`, and `context_type`, `source`, `widget_id` and `conversation_id` are ignored. A full storage allowance is refused with the same 413 and `QUOTA_STORAGE_EXCEEDED`, but the message only says that it is not available right now (not how much is stored: that is the partner\'s business) and `error.details.limit` is `storage`.  An account that administers a partner with a storage destination (`setPartnerStorageDestination`) has its files stored in the partner\'s own bucket instead. Such a file takes none of the allowance, its `url` is served from the partner\'s public address, and its `storage_key` is the key in the partner\'s bucket. The file is never stored with Widgetic instead: when the destination cannot be used the upload is refused with 503 and `STORAGE_DESTINATION_UNAVAILABLE`, and when the partner\'s storage rejects the file with 502 and `STORAGE_DESTINATION_WRITE_FAILED`.  Partner storage is not optional. A partner\'s own uploads (with its API key) and the uploads of its customers\' editor sessions are kept in the partner\'s own storage or not at all, so a partner with no destination (or one that removed it after the session was made) has them refused with 409 and `PARTNER_STORAGE_REQUIRED`; they are never stored with Widgetic. An editor session\'s browser is only told that the feature is not available right now.
      * Upload a file
      */
-    uploadsPost(requestParameters: UploadsPostRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Upload>;
+    uploadsPost(requestParameters: UploadsPost0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Upload>;
     /**
      * Resumable uploads carry a file of up to 250 MB (the limit `tus_max_bytes` of `uploadsLimitsGet`, the same for every account) in pieces that can be resumed after a dropped connection, or after the server was restarted: the pieces wait in shared storage, not on one server. They follow the [tus protocol](https://tus.io): `POST /uploads/tus` declares the file (`Upload-Length` and the `Upload-Metadata` keys `filename`, `filetype` and, optionally, `context_type`, `source`, `widget_id`, `conversation_id` and, to file the upload under one of a partner\'s managed users, `managed_user_id` or `managed_user_external_id`), `PATCH` sends the bytes, `HEAD` says how far a client got. They need a signed-in session; an API key uses `uploadsPost`.  A partner files an upload under one of its managed users with `managed_user_id` (Widgetic\'s id) or `managed_user_external_id` (the partner\'s own id for the user), never both: the same two fields, with the same spelling, as the form fields of `uploadsPost`. The managed user is looked up among the signed-in account\'s own when the upload is declared, so a wrong one is refused before any byte is sent (the declaring `POST /uploads/tus` answers 400, 404 or 409 with a line of text), and is looked up again here, when the file is stored. The stored file then carries the managed user (`managedUserId`), is found by the `managedUserId` filter of `uploadsGet`, and is counted for that user by `getPartnerStorageUsage`. Without either key the file is the account\'s own.  This call stores the finished file: it counts against the account\'s storage allowance only now, not while the file is on its way, so an upload that is abandoned costs nothing. It is safe to call again after a lost answer: the file that was stored is returned, not stored twice. A file that could not be stored (storage down, allowance full) stays available for a day from when the upload began, so the call can be repeated without sending the file again. An unfinished upload is deleted after that day, and an account can hold only a few at once.  A partner account that is paused or not yet activated cannot start a resumable upload (the declaring `POST /uploads/tus` answers 403) and cannot complete one (`PARTNER_SUSPENDED`, `PARTNER_INACTIVE`).
      * Finish a resumable upload — store the file and return it
@@ -87,20 +100,20 @@ export declare class UploadsApi extends runtime.BaseAPI {
 /**
  * @export
  */
-export declare const UploadsPostContextTypeEnum: {
+export declare const UploadsPost0ContextTypeEnum: {
     readonly WidgetCodegen: "widget-codegen";
     readonly BrowserIc: "browser-ic";
     readonly ContentProperty: "content-property";
 };
-export type UploadsPostContextTypeEnum = typeof UploadsPostContextTypeEnum[keyof typeof UploadsPostContextTypeEnum];
+export type UploadsPost0ContextTypeEnum = typeof UploadsPost0ContextTypeEnum[keyof typeof UploadsPost0ContextTypeEnum];
 /**
  * @export
  */
-export declare const UploadsPostSourceEnum: {
+export declare const UploadsPost0SourceEnum: {
     readonly ChatUpload: "chat-upload";
     readonly ChatScreenshot: "chat-screenshot";
     readonly BrowserIcScreenshot: "browser-ic-screenshot";
     readonly PreviewScreenshot: "preview-screenshot";
     readonly FileBrowserUpload: "file-browser-upload";
 };
-export type UploadsPostSourceEnum = typeof UploadsPostSourceEnum[keyof typeof UploadsPostSourceEnum];
+export type UploadsPost0SourceEnum = typeof UploadsPost0SourceEnum[keyof typeof UploadsPost0SourceEnum];

package/dist/apis/UploadsApi.js

@@ -22,7 +22,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UploadsPostSourceEnum = exports.UploadsPostContextTypeEnum = exports.UploadsApi = void 0;
+exports.UploadsPost0SourceEnum = exports.UploadsPost0ContextTypeEnum = exports.UploadsApi = void 0;
 const runtime = require("../runtime");
 const index_1 = require("../models/index");
 /**
@@ -72,6 +72,43 @@ class UploadsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Removes the stored file and the upload row. A file in Widgetic\'s own storage gives back the space it took from your storage allowance; a file in your own bucket is removed from your bucket. Deleting an upload that is already gone succeeds the same way as the first delete. An upload that belongs to another account is not found. If the storage cannot be reached the call fails and nothing is marked deleted, so it can be repeated.
+     * Delete an upload
+     */
+    uploadsIdDeleteRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling uploadsIdDelete().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("apiKeyAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            const response = yield this.request({
+                path: `/uploads/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.UploadsIdDelete200ResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Removes the stored file and the upload row. A file in Widgetic\'s own storage gives back the space it took from your storage allowance; a file in your own bucket is removed from your bucket. Deleting an upload that is already gone succeeds the same way as the first delete. An upload that belongs to another account is not found. If the storage cannot be reached the call fails and nothing is marked deleted, so it can be repeated.
+     * Delete an upload
+     */
+    uploadsIdDelete(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.uploadsIdDeleteRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * The details of one of the account\'s uploads. An upload that belongs to another account is not found.
      * Get an upload by id
@@ -246,7 +283,7 @@ exports.UploadsApi = UploadsApi;
 /**
  * @export
  */
-exports.UploadsPostContextTypeEnum = {
+exports.UploadsPost0ContextTypeEnum = {
     WidgetCodegen: 'widget-codegen',
     BrowserIc: 'browser-ic',
     ContentProperty: 'content-property'
@@ -254,7 +291,7 @@ exports.UploadsPostContextTypeEnum = {
 /**
  * @export
  */
-exports.UploadsPostSourceEnum = {
+exports.UploadsPost0SourceEnum = {
     ChatUpload: 'chat-upload',
     ChatScreenshot: 'chat-screenshot',
     BrowserIcScreenshot: 'browser-ic-screenshot',

package/dist/apis/UsersApi.d.ts

@@ -11,40 +11,40 @@
  */
 import * as runtime from '../runtime';
 import type { AddDomainRequest, CreateUserApiKeyRequest, CreatedUserApiKey, DeletePersonalWorkspaceDomain200Response, DeleteUserApiKey200Response, GetPersonalWorkspaceDomains200Response, GetUserApiKeyUsageLogs200Response, GetUserApiKeys200Response, PersonalWorkspaceDomainResult, UpdateDomainRequest, UpdateUserApiKeyRequest, UserApiKey, UsersMeBillingGet200Response, UsersSendFeedbackPost200Response, UsersSendFeedbackPostRequest } from '../models/index';
-export interface AddPersonalWorkspaceDomainRequest {
+export interface AddPersonalWorkspaceDomain0Request {
     id: string;
     addDomainRequest: AddDomainRequest;
 }
-export interface CreateUserApiKeyOperationRequest {
+export interface CreateUserApiKey0Request {
     id: string;
     createUserApiKeyRequest: CreateUserApiKeyRequest;
     idempotencyKey?: string;
 }
-export interface DeletePersonalWorkspaceDomainRequest {
+export interface DeletePersonalWorkspaceDomain0Request {
     id: string;
     domainId: string;
 }
-export interface DeleteUserApiKeyRequest {
+export interface DeleteUserApiKey0Request {
     id: string;
     keyId: string;
 }
-export interface GetPersonalWorkspaceDomainsRequest {
+export interface GetPersonalWorkspaceDomains0Request {
     id: string;
 }
-export interface GetUserApiKeyUsageLogsRequest {
+export interface GetUserApiKeyUsageLogs0Request {
     id: string;
     keyId: string;
     limit?: number;
 }
-export interface GetUserApiKeysRequest {
+export interface GetUserApiKeys0Request {
     id: string;
 }
-export interface UpdatePersonalWorkspaceDomainRequest {
+export interface UpdatePersonalWorkspaceDomain0Request {
     id: string;
     domainId: string;
     updateDomainRequest: UpdateDomainRequest;
 }
-export interface UpdateUserApiKeyOperationRequest {
+export interface UpdateUserApiKey0Request {
     id: string;
     keyId: string;
     updateUserApiKeyRequest: UpdateUserApiKeyRequest;
@@ -60,42 +60,42 @@ export declare class UsersApi extends runtime.BaseAPI {
      * Adds a website to an account\'s own list. Give a website name such as `example.com`, or `*.example.com` for a website and all of its subdomains. A scheme, a port, a path, capital letters and a leading `www.` are dropped, so `https://www.Example.com/shop` is kept as `example.com`, and `example.com` covers `www.example.com` too. Something that is not a website name is refused, not stored. Until the first website is added nothing is restricted, and a widget can be shown anywhere. Once the list has one, a widget of the account is shown on the listed websites (and on Widgetic\'s own) and nowhere else. A page on your own machine (`localhost`, `127.0.0.1` or `[::1]`, on any port) is always allowed, so there is nothing to add to test locally. A change can take about 15 seconds to reach every server. The list is a safeguard against other websites showing your widgets in a visitor\'s browser. It is not access control: anyone who knows a widget\'s id can still fetch its published content with a plain request that names no website. An account can list at most 50 websites. Use `*.example.com` for a website and all of its subdomains instead of listing each one.
      * Allow a website to show your widgets
      */
-    addPersonalWorkspaceDomainRaw(requestParameters: AddPersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PersonalWorkspaceDomainResult>>;
+    addPersonalWorkspaceDomainRaw(requestParameters: AddPersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PersonalWorkspaceDomainResult>>;
     /**
      * Adds a website to an account\'s own list. Give a website name such as `example.com`, or `*.example.com` for a website and all of its subdomains. A scheme, a port, a path, capital letters and a leading `www.` are dropped, so `https://www.Example.com/shop` is kept as `example.com`, and `example.com` covers `www.example.com` too. Something that is not a website name is refused, not stored. Until the first website is added nothing is restricted, and a widget can be shown anywhere. Once the list has one, a widget of the account is shown on the listed websites (and on Widgetic\'s own) and nowhere else. A page on your own machine (`localhost`, `127.0.0.1` or `[::1]`, on any port) is always allowed, so there is nothing to add to test locally. A change can take about 15 seconds to reach every server. The list is a safeguard against other websites showing your widgets in a visitor\'s browser. It is not access control: anyone who knows a widget\'s id can still fetch its published content with a plain request that names no website. An account can list at most 50 websites. Use `*.example.com` for a website and all of its subdomains instead of listing each one.
      * Allow a website to show your widgets
      */
-    addPersonalWorkspaceDomain(requestParameters: AddPersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PersonalWorkspaceDomainResult>;
+    addPersonalWorkspaceDomain(requestParameters: AddPersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PersonalWorkspaceDomainResult>;
     /**
      * Makes a new API key for an account and returns its secret in `key`. That is the only time the secret is shown: Widgetic keeps a hash, so a key that was not stored cannot be recovered, only replaced. To rotate a key, make the new one, switch the integration over to it, then delete the old one. Only a person signed in on widgetic.com can make a key: a request made with an API key, or with an SDK token, is refused with 403. That way a leaked key cannot be used to make a second one that survives its revocation. Make keys from the dashboard; a key can still list, rename, switch off and delete keys. An `Idempotency-Key` header is required (8 to 50 characters: letters, digits, `-` and `_`). A retry with the same header and the same body returns the same answer instead of making a second key, and the same header with a different body is refused with 422. Make keys one at a time: two requests for the same account that run at the same moment can overwrite each other. A key can be limited to what it needs. Send a `preset` (`read_only`, `content` or `full_access`) or a list of `scopes`, never both. Send neither for a key that can do everything its owner can, as every key made before scopes existed. A limited key is refused with 403 and the code `API_KEY_SCOPE_MISSING` on anything outside its scopes, so a key held by a build server or by a partner\'s backend can be given only the part of the API it uses. The scopes of a key are fixed when it is made: to widen one, make a new key and delete the old one. A limited key cannot make, change or delete keys, exchange tokens or reach the administration routes. The list of scopes is in the `ApiKeyScope` schema. An account can hold at most 25 keys. An account on a plan without API access cannot make one.
      * Create an API key
      */
-    createUserApiKeyRaw(requestParameters: CreateUserApiKeyOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreatedUserApiKey>>;
+    createUserApiKeyRaw(requestParameters: CreateUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreatedUserApiKey>>;
     /**
      * Makes a new API key for an account and returns its secret in `key`. That is the only time the secret is shown: Widgetic keeps a hash, so a key that was not stored cannot be recovered, only replaced. To rotate a key, make the new one, switch the integration over to it, then delete the old one. Only a person signed in on widgetic.com can make a key: a request made with an API key, or with an SDK token, is refused with 403. That way a leaked key cannot be used to make a second one that survives its revocation. Make keys from the dashboard; a key can still list, rename, switch off and delete keys. An `Idempotency-Key` header is required (8 to 50 characters: letters, digits, `-` and `_`). A retry with the same header and the same body returns the same answer instead of making a second key, and the same header with a different body is refused with 422. Make keys one at a time: two requests for the same account that run at the same moment can overwrite each other. A key can be limited to what it needs. Send a `preset` (`read_only`, `content` or `full_access`) or a list of `scopes`, never both. Send neither for a key that can do everything its owner can, as every key made before scopes existed. A limited key is refused with 403 and the code `API_KEY_SCOPE_MISSING` on anything outside its scopes, so a key held by a build server or by a partner\'s backend can be given only the part of the API it uses. The scopes of a key are fixed when it is made: to widen one, make a new key and delete the old one. A limited key cannot make, change or delete keys, exchange tokens or reach the administration routes. The list of scopes is in the `ApiKeyScope` schema. An account can hold at most 25 keys. An account on a plan without API access cannot make one.
      * Create an API key
      */
-    createUserApiKey(requestParameters: CreateUserApiKeyOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreatedUserApiKey>;
+    createUserApiKey(requestParameters: CreateUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreatedUserApiKey>;
     /**
      * Removes one entry from an account\'s own list. When it was the last one, nothing is restricted any more and a widget can be shown anywhere again. A change can take about 15 seconds to reach every server.
      * Stop allowing a website to show your widgets
      */
-    deletePersonalWorkspaceDomainRaw(requestParameters: DeletePersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletePersonalWorkspaceDomain200Response>>;
+    deletePersonalWorkspaceDomainRaw(requestParameters: DeletePersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeletePersonalWorkspaceDomain200Response>>;
     /**
      * Removes one entry from an account\'s own list. When it was the last one, nothing is restricted any more and a widget can be shown anywhere again. A change can take about 15 seconds to reach every server.
      * Stop allowing a website to show your widgets
      */
-    deletePersonalWorkspaceDomain(requestParameters: DeletePersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletePersonalWorkspaceDomain200Response>;
+    deletePersonalWorkspaceDomain(requestParameters: DeletePersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeletePersonalWorkspaceDomain200Response>;
     /**
      * Deletes a key and the record of what it was used for. The key stops working at once on the server that took the request and within a minute on the others, and cannot be brought back: make a new one instead. To stop a key without losing it, switch it off with `updateUserApiKey`.
      * Delete an API key
      */
-    deleteUserApiKeyRaw(requestParameters: DeleteUserApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeleteUserApiKey200Response>>;
+    deleteUserApiKeyRaw(requestParameters: DeleteUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DeleteUserApiKey200Response>>;
     /**
      * Deletes a key and the record of what it was used for. The key stops working at once on the server that took the request and within a minute on the others, and cannot be brought back: make a new one instead. To stop a key without losing it, switch it off with `updateUserApiKey`.
      * Delete an API key
      */
-    deleteUserApiKey(requestParameters: DeleteUserApiKeyRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeleteUserApiKey200Response>;
+    deleteUserApiKey(requestParameters: DeleteUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DeleteUserApiKey200Response>;
     /**
      * Returns the caller\'s profile, including user_role. Any signed-in account may call it.
      * The signed-in account
@@ -110,52 +110,52 @@ export declare class UsersApi extends runtime.BaseAPI {
      * Lists the websites on an account\'s own list, newest first. It is the list Widgetic checks when a widget of the account is embedded: when it holds at least one website, the widget is shown on those websites (and on Widgetic\'s own) and nowhere else; when it is empty, the widget can be shown anywhere. If the account administers a partner, the websites set on the partner record by Widgetic are added to them. Widgets that belong to an organization use the organization\'s list instead.
      * List the websites allowed to show your widgets
      */
-    getPersonalWorkspaceDomainsRaw(requestParameters: GetPersonalWorkspaceDomainsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetPersonalWorkspaceDomains200Response>>;
+    getPersonalWorkspaceDomainsRaw(requestParameters: GetPersonalWorkspaceDomains0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetPersonalWorkspaceDomains200Response>>;
     /**
      * Lists the websites on an account\'s own list, newest first. It is the list Widgetic checks when a widget of the account is embedded: when it holds at least one website, the widget is shown on those websites (and on Widgetic\'s own) and nowhere else; when it is empty, the widget can be shown anywhere. If the account administers a partner, the websites set on the partner record by Widgetic are added to them. Widgets that belong to an organization use the organization\'s list instead.
      * List the websites allowed to show your widgets
      */
-    getPersonalWorkspaceDomains(requestParameters: GetPersonalWorkspaceDomainsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetPersonalWorkspaceDomains200Response>;
+    getPersonalWorkspaceDomains(requestParameters: GetPersonalWorkspaceDomains0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetPersonalWorkspaceDomains200Response>;
     /**
      * Lists the calls made with one key, newest first: when, which path and method, and the status each ended with. Use it to see whether a key is still in use before deleting it, or to see what a key that should not be in use has been doing.
      * Read what an API key was used for
      */
-    getUserApiKeyUsageLogsRaw(requestParameters: GetUserApiKeyUsageLogsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUserApiKeyUsageLogs200Response>>;
+    getUserApiKeyUsageLogsRaw(requestParameters: GetUserApiKeyUsageLogs0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUserApiKeyUsageLogs200Response>>;
     /**
      * Lists the calls made with one key, newest first: when, which path and method, and the status each ended with. Use it to see whether a key is still in use before deleting it, or to see what a key that should not be in use has been doing.
      * Read what an API key was used for
      */
-    getUserApiKeyUsageLogs(requestParameters: GetUserApiKeyUsageLogsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUserApiKeyUsageLogs200Response>;
+    getUserApiKeyUsageLogs(requestParameters: GetUserApiKeyUsageLogs0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUserApiKeyUsageLogs200Response>;
     /**
      * Lists the API keys of an account, in the order they were made: name, the first characters of the key, when it was made, when it expires, when it was last used, whether it is switched on and what it is limited to (`scopes` and `preset`). The secret of a key is never part of the list. A caller can list its own account\'s keys; Widgetic staff can list any account\'s.
      * List the API keys of an account
      */
-    getUserApiKeysRaw(requestParameters: GetUserApiKeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUserApiKeys200Response>>;
+    getUserApiKeysRaw(requestParameters: GetUserApiKeys0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetUserApiKeys200Response>>;
     /**
      * Lists the API keys of an account, in the order they were made: name, the first characters of the key, when it was made, when it expires, when it was last used, whether it is switched on and what it is limited to (`scopes` and `preset`). The secret of a key is never part of the list. A caller can list its own account\'s keys; Widgetic staff can list any account\'s.
      * List the API keys of an account
      */
-    getUserApiKeys(requestParameters: GetUserApiKeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUserApiKeys200Response>;
+    getUserApiKeys(requestParameters: GetUserApiKeys0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetUserApiKeys200Response>;
     /**
      * Replaces the website of one entry on an account\'s own list. The same rules apply as when adding one (`addPersonalWorkspaceDomain`): a website name such as `example.com` or `*.example.com`, kept in its cleaned form, and refused when it is not a website name or is already on the list.
      * Change a website on your list
      */
-    updatePersonalWorkspaceDomainRaw(requestParameters: UpdatePersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PersonalWorkspaceDomainResult>>;
+    updatePersonalWorkspaceDomainRaw(requestParameters: UpdatePersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PersonalWorkspaceDomainResult>>;
     /**
      * Replaces the website of one entry on an account\'s own list. The same rules apply as when adding one (`addPersonalWorkspaceDomain`): a website name such as `example.com` or `*.example.com`, kept in its cleaned form, and refused when it is not a website name or is already on the list.
      * Change a website on your list
      */
-    updatePersonalWorkspaceDomain(requestParameters: UpdatePersonalWorkspaceDomainRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PersonalWorkspaceDomainResult>;
+    updatePersonalWorkspaceDomain(requestParameters: UpdatePersonalWorkspaceDomain0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PersonalWorkspaceDomainResult>;
     /**
      * Renames a key, or switches it off (`isActive: false`) or back on. A key that is switched off is refused at once by the server that took the request and within a minute by the others, and can be switched on again; deleting is for a key that is not coming back. The secret, the expiry and the scopes of a key cannot be changed. Only a key with full access can make these requests: a key limited to some scopes is refused with 403 and the code `API_KEY_SCOPE_MISSING`. Renaming and switching off can be done with an API key. Switching a key on needs a person signed in on widgetic.com: a request that asks for it with an API key or an SDK token is refused with 403, so a leaked key cannot bring a dormant key back to life.
      * Rename an API key, or switch it off or on
      */
-    updateUserApiKeyRaw(requestParameters: UpdateUserApiKeyOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UserApiKey>>;
+    updateUserApiKeyRaw(requestParameters: UpdateUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UserApiKey>>;
     /**
      * Renames a key, or switches it off (`isActive: false`) or back on. A key that is switched off is refused at once by the server that took the request and within a minute by the others, and can be switched on again; deleting is for a key that is not coming back. The secret, the expiry and the scopes of a key cannot be changed. Only a key with full access can make these requests: a key limited to some scopes is refused with 403 and the code `API_KEY_SCOPE_MISSING`. Renaming and switching off can be done with an API key. Switching a key on needs a person signed in on widgetic.com: a request that asks for it with an API key or an SDK token is refused with 403, so a leaked key cannot bring a dormant key back to life.
      * Rename an API key, or switch it off or on
      */
-    updateUserApiKey(requestParameters: UpdateUserApiKeyOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UserApiKey>;
+    updateUserApiKey(requestParameters: UpdateUserApiKey0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UserApiKey>;
     /**
      * Personal workspace billing status for the authenticated user
      */

package/dist/apis/WidgetsApi.d.ts

@@ -10,11 +10,16 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CheckWidgetAccess200Response, CreateWidget201Response, DeleteWidgetRequest, DuplicateWidget201Response, DuplicateWidgetRequest, GetWidgetPublishHistory200Response, GetWidgets200Response, GetWidgetsBatch200Response, GetWidgetsBatchRequest, NewWidget, RenameWidgetPublishHistoryTitle200Response, RenameWidgetPublishHistoryTitleRequest, SetWidgetPublishHistoryLive200Response, UpdateWidgetRepository200Response, UpdateWidgetRepositoryRequest, UpdateWidgetRequest, UploadWidgetThumbnail200Response, UploadWidgetThumbnailRequest } from '../models/index';
+import type { CheckWidgetAccess200Response, CreateCompositionFromWidget201Response, CreateCompositionFromWidgetRequest, CreateWidget201Response, DeleteWidgetRequest, DuplicateWidget201Response, DuplicateWidgetRequest, GetWidgetPublishHistory200Response, GetWidgets200Response, GetWidgetsBatch200Response, GetWidgetsBatchRequest, NewWidget, RenameWidgetPublishHistoryTitle200Response, RenameWidgetPublishHistoryTitleRequest, SetWidgetPublishHistoryLive200Response, UpdateWidgetRepository200Response, UpdateWidgetRepositoryRequest, UpdateWidgetRequest, UploadWidgetThumbnail200Response, UploadWidgetThumbnailRequest } from '../models/index';
 export interface CheckWidgetAccessRequest {
     id: string;
 }
-export interface CreateWidgetRequest {
+export interface CreateCompositionFromWidget0Request {
+    id: string;
+    createCompositionFromWidgetRequest: CreateCompositionFromWidgetRequest;
+    idempotencyKey?: string;
+}
+export interface CreateWidget0Request {
     newWidget: NewWidget;
     idempotencyKey?: string;
 }
@@ -39,16 +44,16 @@ export interface GetWidgetDesignSchemaRequest {
 export interface GetWidgetPublishHistoryRequest {
     widgetId: string;
 }
-export interface GetWidgetsRequest {
+export interface GetWidgetsBatchOperationRequest {
+    getWidgetsBatchRequest: GetWidgetsBatchRequest;
+}
+export interface GetWidgets0Request {
     page?: number;
     size?: number;
     canvasId?: string;
     managedUserId?: string;
     managedUserExternalId?: string;
 }
-export interface GetWidgetsBatchOperationRequest {
-    getWidgetsBatchRequest: GetWidgetsBatchRequest;
-}
 export interface RenameWidgetPublishHistoryTitleOperationRequest {
     widgetId: string;
     version: number;
@@ -84,16 +89,26 @@ export declare class WidgetsApi extends runtime.BaseAPI {
      * Check Widget Access
      */
     checkWidgetAccess(requestParameters: CheckWidgetAccessRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CheckWidgetAccess200Response>;
+    /**
+     * After a managed user publishes a widget from the creator, call this with the widget id, the customer\'s managed user (when the widget is not already filed under one), and optional content, design, embed settings and locale. Every input is validated before a single insert; a failure never leaves a half-made composition.  When the widget is already tagged with a managed user, you may omit `managed_user_id`. When you send it, it must match that tag.  The widget must be published. The `Idempotency-Key` header is required.
+     * Create a composition for a widget in one call
+     */
+    createCompositionFromWidgetRaw(requestParameters: CreateCompositionFromWidget0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateCompositionFromWidget201Response>>;
+    /**
+     * After a managed user publishes a widget from the creator, call this with the widget id, the customer\'s managed user (when the widget is not already filed under one), and optional content, design, embed settings and locale. Every input is validated before a single insert; a failure never leaves a half-made composition.  When the widget is already tagged with a managed user, you may omit `managed_user_id`. When you send it, it must match that tag.  The widget must be published. The `Idempotency-Key` header is required.
+     * Create a composition for a widget in one call
+     */
+    createCompositionFromWidget(requestParameters: CreateCompositionFromWidget0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateCompositionFromWidget201Response>;
     /**
      * Creates a widget for your account: a named record with a type and some starting content, on a canvas of its own (or one of yours that you name), with a database provisioned for it. It costs no credits and has no code yet; the code is generated for it afterwards. The new widget is yours, and you can list it with `getWidgets`. A widget is a draft until you say otherwise (`isDraft: false`).  If the database cannot be provisioned the widget is still created, and `data.warnings` says what did not go through. Read it before relying on the widget.  A widget can be placed on one of your canvases (`canvasId`), in a project you can edit (`projectId`) or in an organization where you may create widgets (`organizationId`). Naming anything you cannot use is refused with 403, and the answer is the same whether it exists or not.  To make the widget for one of your managed users, send `managedUserId` or `managedUserExternalId`. The widget stays in your account and is yours to edit; the tag lets you list one user\'s widgets with `getWidgets`. 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.  Creating a widget provisions its database, so this call has a limit of its own: 120 per minute for each account (ask Widgetic if you need more). Past that the call is answered with 429 and a `Retry-After`. The `Idempotency-Key` header is required; send the same key when you retry, so one widget is created, not two.
      * Create Widget
      */
-    createWidgetRaw(requestParameters: CreateWidgetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateWidget201Response>>;
+    createWidgetRaw(requestParameters: CreateWidget0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateWidget201Response>>;
     /**
      * Creates a widget for your account: a named record with a type and some starting content, on a canvas of its own (or one of yours that you name), with a database provisioned for it. It costs no credits and has no code yet; the code is generated for it afterwards. The new widget is yours, and you can list it with `getWidgets`. A widget is a draft until you say otherwise (`isDraft: false`).  If the database cannot be provisioned the widget is still created, and `data.warnings` says what did not go through. Read it before relying on the widget.  A widget can be placed on one of your canvases (`canvasId`), in a project you can edit (`projectId`) or in an organization where you may create widgets (`organizationId`). Naming anything you cannot use is refused with 403, and the answer is the same whether it exists or not.  To make the widget for one of your managed users, send `managedUserId` or `managedUserExternalId`. The widget stays in your account and is yours to edit; the tag lets you list one user\'s widgets with `getWidgets`. 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.  Creating a widget provisions its database, so this call has a limit of its own: 120 per minute for each account (ask Widgetic if you need more). Past that the call is answered with 429 and a `Retry-After`. The `Idempotency-Key` header is required; send the same key when you retry, so one widget is created, not two.
      * Create Widget
      */
-    createWidget(requestParameters: CreateWidgetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateWidget201Response>;
+    createWidget(requestParameters: CreateWidget0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateWidget201Response>;
     /**
      * Permanently deletes a widget and all related resources. Users can delete their own widgets; admin API key can delete any widget.
      * Delete Widget
@@ -154,16 +169,6 @@ export declare class WidgetsApi extends runtime.BaseAPI {
      * List version history for a widget
      */
     getWidgetPublishHistory(requestParameters: GetWidgetPublishHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWidgetPublishHistory200Response>;
-    /**
-     * Lists the widgets your account owns, newest first. A widget is the reusable piece a composition is made from; this is your own library, not a catalogue of Widgetic\'s widgets.  Pass `page` (counting from 1) and `size` (1 to 100, 20 when left out) to read the list one page at a time. `meta` then carries `total`, `hasNextPage` and `hasPreviousPage`, so a client can walk the list to its end. A page past the end is an empty list. Without `page` and `size` the call returns the whole list in one response, which only suits an account with a few widgets.  Pass `canvasId` to list only the widgets on one of your canvases. That list is always returned whole, whatever `page` and `size` say.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the widgets made for that managed user. The widgets of your other managed users, and your own, are left out. It combines with `page`, `size` and `canvasId`. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.
-     * List Widgets
-     */
-    getWidgetsRaw(requestParameters: GetWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWidgets200Response>>;
-    /**
-     * Lists the widgets your account owns, newest first. A widget is the reusable piece a composition is made from; this is your own library, not a catalogue of Widgetic\'s widgets.  Pass `page` (counting from 1) and `size` (1 to 100, 20 when left out) to read the list one page at a time. `meta` then carries `total`, `hasNextPage` and `hasPreviousPage`, so a client can walk the list to its end. A page past the end is an empty list. Without `page` and `size` the call returns the whole list in one response, which only suits an account with a few widgets.  Pass `canvasId` to list only the widgets on one of your canvases. That list is always returned whole, whatever `page` and `size` say.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the widgets made for that managed user. The widgets of your other managed users, and your own, are left out. It combines with `page`, `size` and `canvasId`. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.
-     * List Widgets
-     */
-    getWidgets(requestParameters?: GetWidgetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWidgets200Response>;
     /**
      * Retrieves multiple widgets by their IDs in a single request. An id that is not found, or that is not yours, is reported in `errors` exactly like one that does not exist. Called with an editor session, only the widgets made for the session\'s managed user are returned.
      * Get Widgets Batch
@@ -174,6 +179,16 @@ export declare class WidgetsApi extends runtime.BaseAPI {
      * Get Widgets Batch
      */
     getWidgetsBatch(requestParameters: GetWidgetsBatchOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWidgetsBatch200Response>;
+    /**
+     * Lists the widgets your account owns, newest first. A widget is the reusable piece a composition is made from; this is your own library, not a catalogue of Widgetic\'s widgets.  Pass `page` (counting from 1) and `size` (1 to 100, 20 when left out) to read the list one page at a time. `meta` then carries `total`, `hasNextPage` and `hasPreviousPage`, so a client can walk the list to its end. A page past the end is an empty list. Without `page` and `size` the call returns the whole list in one response, which only suits an account with a few widgets.  Pass `canvasId` to list only the widgets on one of your canvases. That list is always returned whole, whatever `page` and `size` say.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the widgets made for that managed user. The widgets of your other managed users, and your own, are left out. It combines with `page`, `size` and `canvasId`. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.
+     * List Widgets
+     */
+    getWidgetsRaw(requestParameters: GetWidgets0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetWidgets200Response>>;
+    /**
+     * Lists the widgets your account owns, newest first. A widget is the reusable piece a composition is made from; this is your own library, not a catalogue of Widgetic\'s widgets.  Pass `page` (counting from 1) and `size` (1 to 100, 20 when left out) to read the list one page at a time. `meta` then carries `total`, `hasNextPage` and `hasPreviousPage`, so a client can walk the list to its end. A page past the end is an empty list. Without `page` and `size` the call returns the whole list in one response, which only suits an account with a few widgets.  Pass `canvasId` to list only the widgets on one of your canvases. That list is always returned whole, whatever `page` and `size` say.  Pass `managedUserId` (Widgetic\'s id for one of your managed users) or `managedUserExternalId` (your own identifier for the user) to list only the widgets made for that managed user. The widgets of your other managed users, and your own, are left out. It combines with `page`, `size` and `canvasId`. A managed user that is not yours, or does not exist, is answered with 404 and `MANAGED_USER_NOT_FOUND`.
+     * List Widgets
+     */
+    getWidgets(requestParameters?: GetWidgets0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetWidgets200Response>;
     /**
      * Updates `commit_title` on one version — the owner\'s correction of the wording the codegen pipeline authored for the commit. Works on Draft and Live versions alike; the Live badge says what is being served, the title says what the change was. A whitespace-only title clears it.
      * Rename a version\'s title