@widgetic/api-sdk 1.0.29 → 1.0.31

package/dist/apis/ManagedUsersApi.d.ts

@@ -10,34 +10,49 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CopyMyPresetRequest, CopyPartnerPresetRequest, EditorSession, GetAllManagedUsers200Response, GetManagedUsersByManagerId200Response, ListMyPresets200Response, ManagedUser, ManagedUserUsage, MyPresetCopy, NewEditorSession, NewManagedUser, PartnerPresetCopy, RevokeManagedUserEditorSessions200Response, UpdateManagedUser } from '../models/index';
+import type { CopyMyPresetRequest, CopyPartnerPresetRequest, CreateCompositionFromPresetRequest, CreateCompositionFromWidget201Response, EditorSession, GetAllManagedUsers200Response, GetManagedUserLimits200Response, GetManagedUserStorageUsage200Response, GetManagedUsersByManagerId200Response, GetPartnerDesignDefaults200Response, ListMyPresets200Response, ManagedUser, ManagedUserUsage, MyPresetCopy, NewEditorSession, NewManagedUser, PartnerPresetCopy, RevokeManagedUserEditorSessions200Response, SetManagedUserLimitsRequest, SetPartnerDesignDefaultsRequest, UpdateManagedUser } from '../models/index';
 export interface CopyMyPresetOperationRequest {
     copyMyPresetRequest: CopyMyPresetRequest;
     idempotencyKey?: string;
 }
-export interface CopyPresetForManagedUserRequest {
+export interface CopyPresetForManagedUser0Request {
     id: string;
     key: string;
     idempotencyKey?: string;
     copyPartnerPresetRequest?: CopyPartnerPresetRequest;
 }
-export interface CreateManagedUserRequest {
-    newManagedUser: NewManagedUser;
+export interface CreateCompositionFromPreset0Request {
+    id: string;
+    key: string;
+    createCompositionFromPresetRequest: CreateCompositionFromPresetRequest;
     idempotencyKey?: string;
 }
 export interface CreateManagedUserEditorSessionRequest {
     id: string;
     newEditorSession: NewEditorSession;
 }
-export interface DeleteManagedUserRequest {
+export interface CreateManagedUser0Request {
+    newManagedUser: NewManagedUser;
+    idempotencyKey?: string;
+}
+export interface DeleteManagedUser0Request {
     id: string;
 }
-export interface GetAllManagedUsersRequest {
+export interface GetAllManagedUsers0Request {
     page?: number;
     size?: number;
     sort?: string;
 }
-export interface GetManagedUserByIdRequest {
+export interface GetManagedUserById0Request {
+    id: string;
+}
+export interface GetManagedUserDesignDefaults0Request {
+    id: string;
+}
+export interface GetManagedUserLimits0Request {
+    id: string;
+}
+export interface GetManagedUserStorageUsage0Request {
     id: string;
 }
 export interface GetManagedUserUsageRequest {
@@ -45,7 +60,7 @@ export interface GetManagedUserUsageRequest {
     startDate?: string;
     endDate?: string;
 }
-export interface GetManagedUsersByManagerIdRequest {
+export interface GetManagedUsersByManagerId0Request {
     managerId: string;
     page?: number;
     size?: number;
@@ -58,7 +73,15 @@ export interface RevokeManagedUserEditorSessionRequest {
 export interface RevokeManagedUserEditorSessionsRequest {
     id: string;
 }
-export interface UpdateManagedUserRequest {
+export interface SetManagedUserDesignDefaults0Request {
+    id: string;
+    setPartnerDesignDefaultsRequest: SetPartnerDesignDefaultsRequest;
+}
+export interface SetManagedUserLimits0Request {
+    id: string;
+    setManagedUserLimitsRequest: SetManagedUserLimitsRequest;
+}
+export interface UpdateManagedUser0Request {
     id: string;
     updateManagedUser: UpdateManagedUser;
     idempotencyKey?: string;
@@ -81,22 +104,22 @@ export declare class ManagedUsersApi extends runtime.BaseAPI {
      * Copies the preset `key` (see `setPartnerPreset`) onto a new canvas for one of your managed users, so their widget creator opens on a widget of their own that starts from yours. The copy is a draft widget in your account, filed under the managed user: `getAllWidgets` with `managedUserId` lists it, and no other managed user\'s editor can reach it.  The copy carries the preset\'s code, design and content schemas, and thumbnail, and starts from a fork of its code repository, so the user\'s chat edits begin where yours left off. It does not carry the preset\'s database or its compositions. It is not a preset itself, and changing or removing the preset afterwards never touches it.  To start a composition (the content and design editor) instead, you do not need a copy: call `createComposition` with the preset\'s `widgetId` (from `listPartnerPresets`) and the managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one copy is made, not two. A copy that could not be made leaves nothing behind (503 `PRESET_COPY_FAILED`).  The managed user must be yours and active.
      * Give a managed user a copy of one of your presets
      */
-    copyPresetForManagedUserRaw(requestParameters: CopyPresetForManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerPresetCopy>>;
+    copyPresetForManagedUserRaw(requestParameters: CopyPresetForManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PartnerPresetCopy>>;
     /**
      * Copies the preset `key` (see `setPartnerPreset`) onto a new canvas for one of your managed users, so their widget creator opens on a widget of their own that starts from yours. The copy is a draft widget in your account, filed under the managed user: `getAllWidgets` with `managedUserId` lists it, and no other managed user\'s editor can reach it.  The copy carries the preset\'s code, design and content schemas, and thumbnail, and starts from a fork of its code repository, so the user\'s chat edits begin where yours left off. It does not carry the preset\'s database or its compositions. It is not a preset itself, and changing or removing the preset afterwards never touches it.  To start a composition (the content and design editor) instead, you do not need a copy: call `createComposition` with the preset\'s `widgetId` (from `listPartnerPresets`) and the managed user.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one copy is made, not two. A copy that could not be made leaves nothing behind (503 `PRESET_COPY_FAILED`).  The managed user must be yours and active.
      * Give a managed user a copy of one of your presets
      */
-    copyPresetForManagedUser(requestParameters: CopyPresetForManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerPresetCopy>;
+    copyPresetForManagedUser(requestParameters: CopyPresetForManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PartnerPresetCopy>;
     /**
-     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
-     * Create Managed User
+     * Validates the name, optional content, design, embed settings and locale, then creates a draft composition filed under the managed user, built on the preset\'s widget, in a single insert. A failure never leaves a half-made composition.  The preset\'s widget must be published. The managed user must be yours and active.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create a composition from one of your presets in one call
      */
-    createManagedUserRaw(requestParameters: CreateManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
+    createCompositionFromPresetRaw(requestParameters: CreateCompositionFromPreset0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CreateCompositionFromWidget201Response>>;
     /**
-     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
-     * Create Managed User
+     * Validates the name, optional content, design, embed settings and locale, then creates a draft composition filed under the managed user, built on the preset\'s widget, in a single insert. A failure never leaves a half-made composition.  The preset\'s widget must be published. The managed user must be yours and active.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create a composition from one of your presets in one call
      */
-    createManagedUser(requestParameters: CreateManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
+    createCompositionFromPreset(requestParameters: CreateCompositionFromPreset0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateCompositionFromWidget201Response>;
     /**
      * Makes a short-lived credential that lets the browser of ONE of your managed users use Widgetic\'s editor pieces, such as the File Browser and the composition editor, without your API key ever reaching that browser. Call this from your server when the page that hosts the editor opens, and hand the `token` in the answer to that page.  The token is shown once. It starts with `wgt_ses_` and the browser sends it as `Authorization: Bearer <token>`. It can do only what the `surfaces` you name allow, and only for this managed user:  - `files`: upload a file (`uploadsPost`) and list the files uploaded for this user (`uploadsGet`). Every   file is filed for this user and stored in your own storage destination, never in Widgetic\'s: a file a   customer uploads is yours to keep, and takes none of your storage allowance. Partner storage is not   optional, so no session, whatever its surfaces, can be made until you have set a destination   (`setPartnerStorageDestination`); until then it is refused with 409 and `PARTNER_STORAGE_REQUIRED`, and   when the destination cannot be used with 503 and `STORAGE_DESTINATION_UNAVAILABLE`. A destination you   remove after the session was made stops its uploads too (the same 409; the browser is only told that   the feature is not available right now). To keep a customer from uploading, leave `files` out of the   session and hand the editors your own media library instead (`mediaLibrary`). - `editor`: edit one of this user\'s compositions: read it (`getCompositionById`, its content, design,   embed settings and schemas), check a content change (`validateCompositionContent`), and change its   name, content, design and embed settings (`updateComposition`, `setDynamicContent`). It can reach   only compositions you created for this managed user (tag them with `managedUserId` when you create   them); any other composition, including another of your users\', answers 404. - `creator`: use Widgetic\'s widget creator for this user, including its AI. Draw on canvases and save   them (`getAllCanvases`, `getCanvas`, `createCanvas`, `updateCanvas`, `previewDeleteCanvas`,   `deleteCanvas`); make, change, copy and delete the widgets on them (`createWidget`, `getWidgets`,   `getWidgetsBatch`, `updateWidget`, `uploadWidgetThumbnail`, `duplicateWidget`, `deleteWidget`);   list and make the compositions of a widget it built (`getAllCompositions`, `createComposition`), which   is how it shows the widget with sample values; read and add their   components (`getComponentsByWidgetId`, `createComponent`); keep the   conversation of each widget (`getConversationsByWidgetId`, `createConversationForWidget`,   `updateConversation`, `getMessages`, `createMessage`, `updateMessage`, `restoreCheckpoint`); and read a   widget\'s schemas and give it its repository (`getWidgetContentSchema`, `getWidgetDesignSchema`,   `updateWidgetRepository`). The AI that builds a widget is part of it: list the models   (`agentModelsGet`), open the widget\'s repository (`agentRepositoriesPost`,   `agentRepositoriesRepoIdGet`), start a generation and follow or cancel it (`agentCodeGeneratePost`,   `operationsStreamGet`, `operationsIdGet`, `operationsIdCancelPost`), build and preview the result   (`agentWidgetBuilderRepoHeadWidgetIdGet`, `buildWidgetFromRepo`, `previewWidgetVersion`), publish a   version of the widget and move between its versions (`agentWidgetBuilderPublishWidgetIdPost`,   `getWidgetPublishHistory`, `setWidgetPublishHistoryLive`, `renameWidgetPublishHistoryTitle`), and   turn a stroke or a sentence into a decision (`agentShapeRecognizePost`, `agentDesignResolvePost`). It can   also offer the customer your presets as starting points: read them and ask for a copy for this customer   (`listMyPresets`, `copyMyPreset`; you choose the presets with `setPartnerPreset`).   What the session makes is filed for this managed user, and the lists it reads hold only this user\'s   canvases, widgets and compositions. It can reach only canvases, widgets, compositions, repositories,   uploaded files and operations made for this managed user (tag the canvases and widgets you create   with `managedUserId`); any other canvas, widget, composition, conversation, message, repository, file   or operation, including another of your users\', answers 404. The creator also saves the composition   it is editing (`updateComposition`, from the `editor` surface) and attaches pictures to its chat   (`uploadsPost`, from the `files` surface), and the surfaces do not imply one another: to open the   whole creator for a user, ask for `creator`, `editor` and `files` together. A generation or a build   one user starts can be followed and cancelled by that user and by you, never by another of your   users. The AI is paid for by your account, as your own calls are: its credits and allowances are   yours. A session cannot make a widget public (publishing a version does not), file one under a   project or an organization, or set anything the creator does not set: a body with another field is   refused with 403 and `EDITOR_SESSION_FIELD_NOT_ALLOWED`.  Everything else is refused with 403 and `EDITOR_SESSION_ROUTE_NOT_ALLOWED`: a session cannot read your account, make more sessions, change your presets or delete a composition, and a session without the `creator` surface cannot create or list compositions. Create the composition yourself with your API key, then open the editor on it.  A session ends at `expiresAt` (at most four hours), when you end it (`revokeManagedUserEditorSession`), or when the managed user is switched off or deleted. A managed user can have at most 100 live sessions at once (`429 EDITOR_SESSION_LIMIT_REACHED`). A session that is bound to a web page (`allowed_origin`) is refused from any other origin.  The AI the session runs is paid for with your credits. Set `max_credits` to hold the session to a number of them: once its generations have taken that many (a generation that fails is refunded and does not count), the next one is refused with 402 and `EDITOR_SESSION_CREDIT_LIMIT_REACHED`, and the browser is told only that the feature is not available right now. Without it, the limit Widgetic has set for your account applies when it has set one (the same limit for every session you make, and `max_credits: null` asks for none), and otherwise the credits of your account are the only ceiling. What each of your users\' sessions has spent is in `getManagedUserUsage`.  Each call makes a new session. It does not take an `Idempotency-Key`: the answer holds the token, and the token is never stored where a retry could read it back. The answer is sent with `Cache-Control: no-store`.
      * Create an editor session for a managed user
@@ -107,36 +130,70 @@ export declare class ManagedUsersApi extends runtime.BaseAPI {
      * Create an editor session for a managed user
      */
     createManagedUserEditorSession(requestParameters: CreateManagedUserEditorSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EditorSession>;
+    /**
+     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
+     * Create Managed User
+     */
+    createManagedUserRaw(requestParameters: CreateManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
+    /**
+     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
+     * Create Managed User
+     */
+    createManagedUser(requestParameters: CreateManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
     /**
      * Deletes a managed user by ID. Its editor sessions end with it. What was filed under it (compositions, widgets, uploads) stays in your account, untagged.
      * Delete Managed User
      */
-    deleteManagedUserRaw(requestParameters: DeleteManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    deleteManagedUserRaw(requestParameters: DeleteManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
      * Deletes a managed user by ID. Its editor sessions end with it. What was filed under it (compositions, widgets, uploads) stays in your account, untagged.
      * Delete Managed User
      */
-    deleteManagedUser(requestParameters: DeleteManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    deleteManagedUser(requestParameters: DeleteManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Retrieve the managed users you manage, with pagination support. (Admins see every partner\'s managed users.)
      * Get Managed Users
      */
-    getAllManagedUsersRaw(requestParameters: GetAllManagedUsersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAllManagedUsers200Response>>;
+    getAllManagedUsersRaw(requestParameters: GetAllManagedUsers0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAllManagedUsers200Response>>;
     /**
      * Retrieve the managed users you manage, with pagination support. (Admins see every partner\'s managed users.)
      * Get Managed Users
      */
-    getAllManagedUsers(requestParameters?: GetAllManagedUsersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAllManagedUsers200Response>;
+    getAllManagedUsers(requestParameters?: GetAllManagedUsers0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAllManagedUsers200Response>;
     /**
      * Retrieves a specific managed user by ID.
      * Get Managed User By ID
      */
-    getManagedUserByIdRaw(requestParameters: GetManagedUserByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
+    getManagedUserByIdRaw(requestParameters: GetManagedUserById0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
     /**
      * Retrieves a specific managed user by ID.
      * Get Managed User By ID
      */
-    getManagedUserById(requestParameters: GetManagedUserByIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
+    getManagedUserById(requestParameters: GetManagedUserById0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
+    /**
+     * Read design defaults for one managed user
+     */
+    getManagedUserDesignDefaultsRaw(requestParameters: GetManagedUserDesignDefaults0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetPartnerDesignDefaults200Response>>;
+    /**
+     * Read design defaults for one managed user
+     */
+    getManagedUserDesignDefaults(requestParameters: GetManagedUserDesignDefaults0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetPartnerDesignDefaults200Response>;
+    /**
+     * Read monthly credit cap and usage for one managed user
+     */
+    getManagedUserLimitsRaw(requestParameters: GetManagedUserLimits0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetManagedUserLimits200Response>>;
+    /**
+     * Read monthly credit cap and usage for one managed user
+     */
+    getManagedUserLimits(requestParameters: GetManagedUserLimits0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetManagedUserLimits200Response>;
+    /**
+     * Storage used by one managed user\'s uploads
+     */
+    getManagedUserStorageUsageRaw(requestParameters: GetManagedUserStorageUsage0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetManagedUserStorageUsage200Response>>;
+    /**
+     * Storage used by one managed user\'s uploads
+     */
+    getManagedUserStorageUsage(requestParameters: GetManagedUserStorageUsage0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetManagedUserStorageUsage200Response>;
     /**
      * Says how many credits the editor sessions of one of your managed users took from your account over a period, in total and for each operation. A generation costs one credit, taken from your account when it starts; one that fails is refunded and is counted as refunded, not as spent.  Only what was spent through editor sessions is here, and only since usage was first recorded: what you spend with your API key, and anything from before, is not. Use it to see which of your users spend the most, or to charge them for it. To hold one session to a number of credits, set `max_credits` when you make it (`createManagedUserEditorSession`).  The period runs from `startDate` (included) to `endDate` (not included): the 30 days before now when you give neither, and at most 366 days. A date without a time is midnight UTC at the start of that day, so for all of October give `startDate=2026-10-01` and `endDate=2026-11-01`.
      * What a managed user\'s editor sessions spent
@@ -151,12 +208,12 @@ export declare class ManagedUsersApi extends runtime.BaseAPI {
      * Retrieve managed users for a specific manager with pagination support.
      * Get Managed Users By Manager
      */
-    getManagedUsersByManagerIdRaw(requestParameters: GetManagedUsersByManagerIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetManagedUsersByManagerId200Response>>;
+    getManagedUsersByManagerIdRaw(requestParameters: GetManagedUsersByManagerId0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetManagedUsersByManagerId200Response>>;
     /**
      * Retrieve managed users for a specific manager with pagination support.
      * Get Managed Users By Manager
      */
-    getManagedUsersByManagerId(requestParameters: GetManagedUsersByManagerIdRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetManagedUsersByManagerId200Response>;
+    getManagedUsersByManagerId(requestParameters: GetManagedUsersByManagerId0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetManagedUsersByManagerId200Response>;
     /**
      * Lists the presets your account offers (`setPartnerPreset`), as the picker in a customer\'s widget creator shows them: a key, a title, a description and a thumbnail, in the order you gave them. It is what the widget creator module reads when it opens with nothing of the customer\'s own yet.  Call it with an editor session (`createManagedUserEditorSession`, surface `creator`). The session acts as your account and names the one customer it is for, so a customer reads only your presets, and nothing in the request chooses whose. Called with your API key it is refused with 403 and `EDITOR_SESSION_REQUIRED`: you read your own list with `listPartnerPresets`, which also tells you the widget behind each preset.
      * The starting points a customer\'s editor session may copy
@@ -187,14 +244,34 @@ export declare class ManagedUsersApi extends runtime.BaseAPI {
      * End every editor session of a managed user
      */
     revokeManagedUserEditorSessions(requestParameters: RevokeManagedUserEditorSessionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RevokeManagedUserEditorSessions200Response>;
+    /**
+     * Send `{ \"design\": { ... } }` to store a JSON object (at most 64 KB, nesting depth 32), or `{ \"design\": null }` to remove the override. New compositions for this customer merge this layer over the partner default and under the request body.
+     * Set or clear design defaults for one managed user
+     */
+    setManagedUserDesignDefaultsRaw(requestParameters: SetManagedUserDesignDefaults0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Send `{ \"design\": { ... } }` to store a JSON object (at most 64 KB, nesting depth 32), or `{ \"design\": null }` to remove the override. New compositions for this customer merge this layer over the partner default and under the request body.
+     * Set or clear design defaults for one managed user
+     */
+    setManagedUserDesignDefaults(requestParameters: SetManagedUserDesignDefaults0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Send monthly_credits as a whole number from 0 up to 2147483647 to cap what this customer\'s editor sessions may spend in a UTC calendar month, or null to remove the cap. The cap counts the credits the customer\'s sessions spent that month (refunded credits do not count) and applies to all of the customer\'s sessions together, beside any `max_credits` a single session was given. A cap of 0 stops all paid work by this customer until you raise it. The cap starts counting from the first of the month (UTC); a cap set below what was already spent this month stops further work at once.
+     * Set or clear the monthly credit cap for one managed user
+     */
+    setManagedUserLimitsRaw(requestParameters: SetManagedUserLimits0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Send monthly_credits as a whole number from 0 up to 2147483647 to cap what this customer\'s editor sessions may spend in a UTC calendar month, or null to remove the cap. The cap counts the credits the customer\'s sessions spent that month (refunded credits do not count) and applies to all of the customer\'s sessions together, beside any `max_credits` a single session was given. A cap of 0 stops all paid work by this customer until you raise it. The cap starts counting from the first of the month (UTC); a cap set below what was already spent this month stops further work at once.
+     * Set or clear the monthly credit cap for one managed user
+     */
+    setManagedUserLimits(requestParameters: SetManagedUserLimits0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Updates an existing managed user. Only `external_id`, `metadata` and `is_active` can change, and `metadata` is replaced as a whole, so send all of it. `is_active: false` switches the managed user off: what it already has stays, and nothing new can be filed under it until you send `is_active: true`. Switching it off also ends all of its editor sessions, and they do not come back when you switch it on again.  The `Idempotency-Key` header is required (`400` without it).
      * Update Managed User
      */
-    updateManagedUserRaw(requestParameters: UpdateManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
+    updateManagedUserRaw(requestParameters: UpdateManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ManagedUser>>;
     /**
      * Updates an existing managed user. Only `external_id`, `metadata` and `is_active` can change, and `metadata` is replaced as a whole, so send all of it. `is_active: false` switches the managed user off: what it already has stays, and nothing new can be filed under it until you send `is_active: true`. Switching it off also ends all of its editor sessions, and they do not come back when you switch it on again.  The `Idempotency-Key` header is required (`400` without it).
      * Update Managed User
      */
-    updateManagedUser(requestParameters: UpdateManagedUserRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
+    updateManagedUser(requestParameters: UpdateManagedUser0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ManagedUser>;
 }

package/dist/apis/ManagedUsersApi.js

@@ -117,13 +117,19 @@ class ManagedUsersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
-     * Create Managed User
+     * Validates the name, optional content, design, embed settings and locale, then creates a draft composition filed under the managed user, built on the preset\'s widget, in a single insert. A failure never leaves a half-made composition.  The preset\'s widget must be published. The managed user must be yours and active.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create a composition from one of your presets in one call
      */
-    createManagedUserRaw(requestParameters, initOverrides) {
+    createCompositionFromPresetRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (requestParameters['newManagedUser'] == null) {
-                throw new runtime.RequiredError('newManagedUser', 'Required parameter "newManagedUser" was null or undefined when calling createManagedUser().');
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling createCompositionFromPreset().');
+            }
+            if (requestParameters['key'] == null) {
+                throw new runtime.RequiredError('key', 'Required parameter "key" was null or undefined when calling createCompositionFromPreset().');
+            }
+            if (requestParameters['createCompositionFromPresetRequest'] == null) {
+                throw new runtime.RequiredError('createCompositionFromPresetRequest', 'Required parameter "createCompositionFromPresetRequest" was null or undefined when calling createCompositionFromPreset().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -139,22 +145,22 @@ class ManagedUsersApi extends runtime.BaseAPI {
                 }
             }
             const response = yield this.request({
-                path: `/managed-users`,
+                path: `/managed-users/{id}/presets/{key}/composition`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))).replace(`{${"key"}}`, encodeURIComponent(String(requestParameters['key']))),
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: (0, index_1.NewManagedUserToJSON)(requestParameters['newManagedUser']),
+                body: (0, index_1.CreateCompositionFromPresetRequestToJSON)(requestParameters['createCompositionFromPresetRequest']),
             }, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ManagedUserFromJSON)(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.CreateCompositionFromWidget201ResponseFromJSON)(jsonValue));
         });
     }
     /**
-     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
-     * Create Managed User
+     * Validates the name, optional content, design, embed settings and locale, then creates a draft composition filed under the managed user, built on the preset\'s widget, in a single insert. A failure never leaves a half-made composition.  The preset\'s widget must be published. The managed user must be yours and active.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one composition is created, not two.
+     * Create a composition from one of your presets in one call
      */
-    createManagedUser(requestParameters, initOverrides) {
+    createCompositionFromPreset(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.createManagedUserRaw(requestParameters, initOverrides);
+            const response = yield this.createCompositionFromPresetRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -200,6 +206,48 @@ class ManagedUsersApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
+     * Create Managed User
+     */
+    createManagedUserRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['newManagedUser'] == null) {
+                throw new runtime.RequiredError('newManagedUser', 'Required parameter "newManagedUser" was null or undefined when calling createManagedUser().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['idempotencyKey'] != null) {
+                headerParameters['Idempotency-Key'] = String(requestParameters['idempotencyKey']);
+            }
+            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: `/managed-users`,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.NewManagedUserToJSON)(requestParameters['newManagedUser']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ManagedUserFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Creates a new managed user for a partner account.  The `Idempotency-Key` header is required (`400` without it). Send the same key when you retry, so one managed user is created, not two.
+     * Create Managed User
+     */
+    createManagedUser(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createManagedUserRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Deletes a managed user by ID. Its editor sessions end with it. What was filed under it (compositions, widgets, uploads) stays in your account, untagged.
      * Delete Managed User
@@ -316,6 +364,111 @@ class ManagedUsersApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Read design defaults for one managed user
+     */
+    getManagedUserDesignDefaultsRaw(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 getManagedUserDesignDefaults().');
+            }
+            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: `/managed-users/{id}/design-defaults`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.GetPartnerDesignDefaults200ResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Read design defaults for one managed user
+     */
+    getManagedUserDesignDefaults(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getManagedUserDesignDefaultsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Read monthly credit cap and usage for one managed user
+     */
+    getManagedUserLimitsRaw(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 getManagedUserLimits().');
+            }
+            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: `/managed-users/{id}/limits`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.GetManagedUserLimits200ResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Read monthly credit cap and usage for one managed user
+     */
+    getManagedUserLimits(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getManagedUserLimitsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Storage used by one managed user\'s uploads
+     */
+    getManagedUserStorageUsageRaw(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 getManagedUserStorageUsage().');
+            }
+            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: `/managed-users/{id}/storage-usage`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.GetManagedUserStorageUsage200ResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Storage used by one managed user\'s uploads
+     */
+    getManagedUserStorageUsage(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getManagedUserStorageUsageRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Says how many credits the editor sessions of one of your managed users took from your account over a period, in total and for each operation. A generation costs one credit, taken from your account when it starts; one that fails is refunded and is counted as refunded, not as spent.  Only what was spent through editor sessions is here, and only since usage was first recorded: what you spend with your API key, and anything from before, is not. Use it to see which of your users spend the most, or to charge them for it. To hold one session to a number of credits, set `max_credits` when you make it (`createManagedUserEditorSession`).  The period runs from `startDate` (included) to `endDate` (not included): the 30 days before now when you give neither, and at most 366 days. A date without a time is midnight UTC at the start of that day, so for all of October give `startDate=2026-10-01` and `endDate=2026-11-01`.
      * What a managed user\'s editor sessions spent
@@ -515,6 +668,88 @@ class ManagedUsersApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Send `{ \"design\": { ... } }` to store a JSON object (at most 64 KB, nesting depth 32), or `{ \"design\": null }` to remove the override. New compositions for this customer merge this layer over the partner default and under the request body.
+     * Set or clear design defaults for one managed user
+     */
+    setManagedUserDesignDefaultsRaw(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 setManagedUserDesignDefaults().');
+            }
+            if (requestParameters['setPartnerDesignDefaultsRequest'] == null) {
+                throw new runtime.RequiredError('setPartnerDesignDefaultsRequest', 'Required parameter "setPartnerDesignDefaultsRequest" was null or undefined when calling setManagedUserDesignDefaults().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            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: `/managed-users/{id}/design-defaults`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.SetPartnerDesignDefaultsRequestToJSON)(requestParameters['setPartnerDesignDefaultsRequest']),
+            }, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Send `{ \"design\": { ... } }` to store a JSON object (at most 64 KB, nesting depth 32), or `{ \"design\": null }` to remove the override. New compositions for this customer merge this layer over the partner default and under the request body.
+     * Set or clear design defaults for one managed user
+     */
+    setManagedUserDesignDefaults(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.setManagedUserDesignDefaultsRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Send monthly_credits as a whole number from 0 up to 2147483647 to cap what this customer\'s editor sessions may spend in a UTC calendar month, or null to remove the cap. The cap counts the credits the customer\'s sessions spent that month (refunded credits do not count) and applies to all of the customer\'s sessions together, beside any `max_credits` a single session was given. A cap of 0 stops all paid work by this customer until you raise it. The cap starts counting from the first of the month (UTC); a cap set below what was already spent this month stops further work at once.
+     * Set or clear the monthly credit cap for one managed user
+     */
+    setManagedUserLimitsRaw(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 setManagedUserLimits().');
+            }
+            if (requestParameters['setManagedUserLimitsRequest'] == null) {
+                throw new runtime.RequiredError('setManagedUserLimitsRequest', 'Required parameter "setManagedUserLimitsRequest" was null or undefined when calling setManagedUserLimits().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            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: `/managed-users/{id}/limits`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.SetManagedUserLimitsRequestToJSON)(requestParameters['setManagedUserLimitsRequest']),
+            }, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Send monthly_credits as a whole number from 0 up to 2147483647 to cap what this customer\'s editor sessions may spend in a UTC calendar month, or null to remove the cap. The cap counts the credits the customer\'s sessions spent that month (refunded credits do not count) and applies to all of the customer\'s sessions together, beside any `max_credits` a single session was given. A cap of 0 stops all paid work by this customer until you raise it. The cap starts counting from the first of the month (UTC); a cap set below what was already spent this month stops further work at once.
+     * Set or clear the monthly credit cap for one managed user
+     */
+    setManagedUserLimits(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.setManagedUserLimitsRaw(requestParameters, initOverrides);
+        });
+    }
     /**
      * Updates an existing managed user. Only `external_id`, `metadata` and `is_active` can change, and `metadata` is replaced as a whole, so send all of it. `is_active: false` switches the managed user off: what it already has stays, and nothing new can be filed under it until you send `is_active: true`. Switching it off also ends all of its editor sessions, and they do not come back when you switch it on again.  The `Idempotency-Key` header is required (`400` without it).
      * Update Managed User

package/dist/apis/OperationsApi.d.ts

@@ -15,7 +15,7 @@ export interface OperationsIdCancelPostRequest {
     id: string;
     idempotencyKey?: string;
 }
-export interface OperationsIdGetRequest {
+export interface OperationsIdGet0Request {
     id: string;
 }
 export interface OperationsStreamGetRequest {
@@ -39,12 +39,12 @@ export declare class OperationsApi extends runtime.BaseAPI {
      * Follows work that carries on after the response that started it. Duplicating a composition, for one, answers 202 with an `operationId`: ask for that operation until its `status` is `completed` (or `failed`, with the reason in `error`). A finished duplication names the new composition in `metadata.newCompositionId`.  An operation belongs to the user who started it. Asking for somebody else\'s operation answers 404, exactly as for one that does not exist. Administrators may read any operation.
      * Get operation status
      */
-    operationsIdGetRaw(requestParameters: OperationsIdGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<OperationsIdGet200Response>>;
+    operationsIdGetRaw(requestParameters: OperationsIdGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<OperationsIdGet200Response>>;
     /**
      * Follows work that carries on after the response that started it. Duplicating a composition, for one, answers 202 with an `operationId`: ask for that operation until its `status` is `completed` (or `failed`, with the reason in `error`). A finished duplication names the new composition in `metadata.newCompositionId`.  An operation belongs to the user who started it. Asking for somebody else\'s operation answers 404, exactly as for one that does not exist. Administrators may read any operation.
      * Get operation status
      */
-    operationsIdGet(requestParameters: OperationsIdGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<OperationsIdGet200Response>;
+    operationsIdGet(requestParameters: OperationsIdGet0Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<OperationsIdGet200Response>;
     /**
      * Opens a server-sent events stream for long-running operations.  An operation belongs to the user who started it, so the stream carries your own operations only. Following an operation that is somebody else\'s answers 404, exactly as for one that does not exist. Administrators may follow any operation.  Cross-origin access follows the gateway\'s origin allow-list; the stream never answers with a wildcard `Access-Control-Allow-Origin`.
      * Stream operation updates