@cadenya/cadenya 0.124.0 → 0.126.0

package/src/resources/index.ts

@@ -3,6 +3,11 @@
 export * from './shared';
 export {
   AIProviderKeys,
+  type AIProviderConfigOpenAI,
+  type AIProviderConfigOpenAICompatible,
+  type AIProviderConfigOpenrouter,
+  type AIProviderCredentialAPIKey,
+  type AIProviderCredentialHeaders,
   type AIProviderKey,
   type AIProviderKeySpec,
   type AIProviderKeyCreateParams,
@@ -85,6 +90,9 @@ export {
   type AssistantMessage,
   type AssistantToolCall,
   type CallableTool,
+  type CallableToolAgent,
+  type CallableToolCadenyaProvidedTool,
+  type CallableToolTool,
   type ContextLengths,
   type ContextWindowCompacted,
   type MemoryRead,
@@ -97,6 +105,23 @@ export {
   type ObjectiveError,
   type ObjectiveEvent,
   type ObjectiveEventData,
+  type ObjectiveEventDataAssistantMessage,
+  type ObjectiveEventDataCancelled,
+  type ObjectiveEventDataContextWindowCompacted,
+  type ObjectiveEventDataError,
+  type ObjectiveEventDataFinalized,
+  type ObjectiveEventDataMemoryRead,
+  type ObjectiveEventDataNotice,
+  type ObjectiveEventDataSubAgentSpawned,
+  type ObjectiveEventDataSubAgentUpdated,
+  type ObjectiveEventDataTimedOut,
+  type ObjectiveEventDataToolApprovalRequested,
+  type ObjectiveEventDataToolApproved,
+  type ObjectiveEventDataToolCalled,
+  type ObjectiveEventDataToolDenied,
+  type ObjectiveEventDataToolError,
+  type ObjectiveEventDataToolResult,
+  type ObjectiveEventDataUserMessage,
   type ObjectiveEventInfo,
   type ObjectiveEventWebhookData,
   type ObjectiveInfo,
@@ -135,8 +160,15 @@ export {
 export {
   ToolSets,
   type ApprovalRequirementFilter,
+  type ApprovalRequirementFilterAlways,
+  type ApprovalRequirementFilterOnly,
   type AttributeFilter,
   type StringMatcher,
+  type StringMatcherContains,
+  type StringMatcherEndsWith,
+  type StringMatcherExact,
+  type StringMatcherRegex,
+  type StringMatcherStartsWith,
   type SyncCompleted,
   type SyncFailed,
   type SyncStarted,
@@ -144,11 +176,20 @@ export {
   type ToolSet,
   type ToolSetAdapter,
   type ToolSetAdapterBare,
+  type ToolSetAdapterBareVariant,
   type ToolSetAdapterHTTP,
-  type ToolSetAdapterMcp,
+  type ToolSetAdapterHTTPVariant,
+  type ToolSetAdapterMCP,
+  type ToolSetAdapterMCPVariant,
   type ToolSetAdapterOpenAPI,
+  type ToolSetAdapterOpenAPIUploadID,
+  type ToolSetAdapterOpenAPIURL,
+  type ToolSetAdapterOpenAPIVariant,
   type ToolSetEvent,
   type ToolSetEventData,
+  type ToolSetEventDataSyncCompleted,
+  type ToolSetEventDataSyncFailed,
+  type ToolSetEventDataSyncStarted,
   type ToolSetInfo,
   type ToolSetSpec,
   type ToolSetGetOpenAPISpecResponse,
@@ -177,8 +218,10 @@ export {
   WorkspaceAdmin,
   type WorkspaceMember,
   type WorkspaceAdminCreateParams,
+  type WorkspaceAdminRetrieveParams,
   type WorkspaceAdminUpdateParams,
   type WorkspaceAdminListParams,
+  type WorkspaceAdminArchiveParams,
   type WorkspaceMembersCursorPagination,
 } from './workspace-admin/workspace-admin';
 export {

package/src/resources/memory-layers/entries.ts

@@ -25,7 +25,7 @@ export class Entries extends APIResource {
     params: EntryCreateParams,
     options?: RequestOptions,
   ): APIPromise<MemoryEntryDetail> {
-    const { workspaceId, ...body } = params;
+    const { workspaceId = this._client.workspaceID, ...body } = params;
     return this._client.post(path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries`, {
       body,
       ...options,
@@ -36,10 +36,15 @@ export class Entries extends APIResource {
    * Retrieves a memory entry by ID from a memory layer. Returns the detail view,
    * including the content body.
    */
-  retrieve(id: string, params: EntryRetrieveParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
-    const { workspaceId, memoryLayerId } = params;
+  retrieve(
+    memoryLayerID: string,
+    id: string,
+    params: EntryRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MemoryEntryDetail> {
+    const { workspaceId = this._client.workspaceID } = params ?? {};
     return this._client.get(
-      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries/${id}`,
       options,
     );
   }
@@ -48,10 +53,15 @@ export class Entries extends APIResource {
    * Updates a memory entry in a memory layer. Returns the detail view, including the
    * resolved content body.
    */
-  update(id: string, params: EntryUpdateParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
-    const { workspaceId, memoryLayerId, ...body } = params;
+  update(
+    memoryLayerID: string,
+    id: string,
+    params: EntryUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<MemoryEntryDetail> {
+    const { workspaceId = this._client.workspaceID, ...body } = params;
     return this._client.patch(
-      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries/${id}`,
       { body, ...options },
     );
   }
@@ -61,10 +71,10 @@ export class Entries extends APIResource {
    */
   list(
     memoryLayerID: string,
-    params: EntryListParams,
+    params: EntryListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<MemoryEntriesCursorPagination, MemoryEntry> {
-    const { workspaceId, ...query } = params;
+    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
     return this._client.getAPIList(
       path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries`,
       CursorPagination<MemoryEntry>,
@@ -75,10 +85,15 @@ export class Entries extends APIResource {
   /**
    * Deletes a memory entry from a memory layer
    */
-  delete(id: string, params: EntryDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { workspaceId, memoryLayerId } = params;
+  delete(
+    memoryLayerID: string,
+    id: string,
+    params: EntryDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { workspaceId = this._client.workspaceID } = params ?? {};
     return this._client.delete(
-      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries/${id}`,
       { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
     );
   }
@@ -118,24 +133,39 @@ export interface MemoryEntry {
  * either inline content or a reference to a completed Upload; exactly one of the
  * two must be set.
  */
-export interface MemoryEntryCreateSpec {
-  /**
-   * See MemoryEntrySpec.key for the full rule set. Same constraints apply here.
-   */
-  key: string;
+export type MemoryEntryCreateSpec = MemoryEntryCreateSpecContent | MemoryEntryCreateSpecUploadID;
 
+export interface MemoryEntryCreateSpecContent {
   /**
    * Inline content, written directly into the entry.
    */
-  content?: string;
+  content: string;
+
+  type: 'content';
 
   description?: string;
 
+  /**
+   * See MemoryEntrySpec.key for the full rule set. Same constraints apply here.
+   */
+  key?: string;
+}
+
+export interface MemoryEntryCreateSpecUploadID {
+  type: 'uploadId';
+
   /**
    * ID of a COMPLETE Upload. The server reads the object from storage, copies its
    * bytes into the entry, and marks the upload consumed.
    */
-  uploadId?: string;
+  uploadId: string;
+
+  description?: string;
+
+  /**
+   * See MemoryEntrySpec.key for the full rule set. Same constraints apply here.
+   */
+  key?: string;
 }
 
 /**
@@ -236,7 +266,7 @@ export interface EntryCreateParams {
   /**
    * Path param
    */
-  workspaceId: string;
+  workspaceId?: string;
 
   /**
    * Body param: CreateResourceMetadata contains the user-provided fields for
@@ -255,25 +285,14 @@ export interface EntryCreateParams {
 }
 
 export interface EntryRetrieveParams {
-  workspaceId: string;
-
-  /**
-   * Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
-   */
-  memoryLayerId: string;
+  workspaceId?: string;
 }
 
 export interface EntryUpdateParams {
   /**
    * Path param
    */
-  workspaceId: string;
-
-  /**
-   * Path param: Memory layer ID. Accepts canonical memlyr\_… form or
-   * external_id:<value> form.
-   */
-  memoryLayerId: string;
+  workspaceId?: string;
 
   /**
    * Body param: UpdateResourceMetadata contains the user-provided fields for
@@ -301,7 +320,7 @@ export interface EntryListParams extends CursorPaginationParams {
   /**
    * Path param
    */
-  workspaceId: string;
+  workspaceId?: string;
 
   /**
    * Query param: When set to true you may use more of your alloted API rate-limit
@@ -333,18 +352,15 @@ export interface EntryListParams extends CursorPaginationParams {
 }
 
 export interface EntryDeleteParams {
-  workspaceId: string;
-
-  /**
-   * Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
-   */
-  memoryLayerId: string;
+  workspaceId?: string;
 }
 
 export declare namespace Entries {
   export {
     type MemoryEntry as MemoryEntry,
     type MemoryEntryCreateSpec as MemoryEntryCreateSpec,
+    type MemoryEntryCreateSpecContent as MemoryEntryCreateSpecContent,
+    type MemoryEntryCreateSpecUploadID as MemoryEntryCreateSpecUploadID,
     type MemoryEntryDetail as MemoryEntryDetail,
     type MemoryEntryInfo as MemoryEntryInfo,
     type MemoryEntrySpec as MemoryEntrySpec,

package/src/resources/memory-layers/index.ts

@@ -4,6 +4,8 @@ export {
   Entries,
   type MemoryEntry,
   type MemoryEntryCreateSpec,
+  type MemoryEntryCreateSpecContent,
+  type MemoryEntryCreateSpecUploadID,
   type MemoryEntryDetail,
   type MemoryEntryInfo,
   type MemoryEntrySpec,

package/src/resources/memory-layers/memory-layers.ts

@@ -14,6 +14,8 @@ import {
   MemoryEntriesCursorPagination,
   MemoryEntry,
   MemoryEntryCreateSpec,
+  MemoryEntryCreateSpecContent,
+  MemoryEntryCreateSpecUploadID,
   MemoryEntryDetail,
   MemoryEntryInfo,
   MemoryEntrySpec,
@@ -37,19 +39,20 @@ export class MemoryLayers extends APIResource {
   /**
    * Creates a new memory layer in the workspace
    */
-  create(
-    workspaceID: string,
-    body: MemoryLayerCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<MemoryLayer> {
-    return this._client.post(path`/v1/workspaces/${workspaceID}/memory_layers`, { body, ...options });
+  create(params: MemoryLayerCreateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    const { workspaceId = this._client.workspaceID, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/memory_layers`, { body, ...options });
   }
 
   /**
    * Retrieves a memory layer by ID from the workspace
    */
-  retrieve(id: string, params: MemoryLayerRetrieveParams, options?: RequestOptions): APIPromise<MemoryLayer> {
-    const { workspaceId } = params;
+  retrieve(
+    id: string,
+    params: MemoryLayerRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MemoryLayer> {
+    const { workspaceId = this._client.workspaceID } = params ?? {};
     return this._client.get(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, options);
   }
 
@@ -57,7 +60,7 @@ export class MemoryLayers extends APIResource {
    * Updates a memory layer in the workspace
    */
   update(id: string, params: MemoryLayerUpdateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
-    const { workspaceId, ...body } = params;
+    const { workspaceId = this._client.workspaceID, ...body } = params;
     return this._client.patch(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, { body, ...options });
   }
 
@@ -65,12 +68,12 @@ export class MemoryLayers extends APIResource {
    * Lists all memory layers in the workspace
    */
   list(
-    workspaceID: string,
-    query: MemoryLayerListParams | null | undefined = {},
+    params: MemoryLayerListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<MemoryLayersCursorPagination, MemoryLayer> {
+    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
     return this._client.getAPIList(
-      path`/v1/workspaces/${workspaceID}/memory_layers`,
+      path`/v1/workspaces/${workspaceId}/memory_layers`,
       CursorPagination<MemoryLayer>,
       { query, ...options },
     );
@@ -79,8 +82,12 @@ export class MemoryLayers extends APIResource {
   /**
    * Deletes a memory layer from the workspace
    */
-  delete(id: string, params: MemoryLayerDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { workspaceId } = params;
+  delete(
+    id: string,
+    params: MemoryLayerDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { workspaceId = this._client.workspaceID } = params ?? {};
     return this._client.delete(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -172,24 +179,33 @@ export interface MemoryLayerSpec {
 
 export interface MemoryLayerCreateParams {
   /**
-   * CreateResourceMetadata contains the user-provided fields for creating a
-   * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
-   * profile_id, created_at) are excluded since they are set by the server.
+   * Path param
+   */
+  workspaceId?: string;
+
+  /**
+   * Body param: CreateResourceMetadata contains the user-provided fields for
+   * creating a workspace-scoped resource. Read-only fields (id, account_id,
+   * workspace_id, profile_id, created_at) are excluded since they are set by the
+   * server.
    */
   metadata: Shared.CreateResourceMetadata;
 
+  /**
+   * Body param
+   */
   spec: MemoryLayerSpec;
 }
 
 export interface MemoryLayerRetrieveParams {
-  workspaceId: string;
+  workspaceId?: string;
 }
 
 export interface MemoryLayerUpdateParams {
   /**
    * Path param
    */
-  workspaceId: string;
+  workspaceId?: string;
 
   /**
    * Body param: UpdateResourceMetadata contains the user-provided fields for
@@ -212,52 +228,57 @@ export interface MemoryLayerUpdateParams {
 
 export interface MemoryLayerListParams extends CursorPaginationParams {
   /**
-   * Filter to episodic layers belonging to this agent.
+   * Path param
+   */
+  workspaceId?: string;
+
+  /**
+   * Query param: Filter to episodic layers belonging to this agent.
    */
   agentId?: string;
 
   /**
-   * Filter to episodic layers whose episodic key starts with this prefix (e.g.
-   * "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
-   * keys, similar to a redis key scan.
+   * Query param: Filter to episodic layers whose episodic key starts with this
+   * prefix (e.g. "customer/" matches "customer/42" and "customer/43"). Useful for
+   * namespaced keys, similar to a redis key scan.
    */
   episodicKeyPrefix?: string;
 
   /**
-   * When set to true you may use more of your alloted API rate-limit
+   * Query param: When set to true you may use more of your alloted API rate-limit
    */
   includeInfo?: boolean;
 
   /**
-   * Filters by metadata labels. Comma-separated key=value pairs, e.g.
+   * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
    * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
    * semantics).
    */
   labels?: string;
 
   /**
-   * Filter expression (query param: prefix)
+   * Query param: Filter expression (query param: prefix)
    */
   prefix?: string;
 
   /**
-   * Free-form search query
+   * Query param: Free-form search query
    */
   query?: string;
 
   /**
-   * Sort order for results (asc or desc by creation time)
+   * Query param: Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
 
   /**
-   * Filter by layer type
+   * Query param: Filter by layer type
    */
   type?: 'MEMORY_LAYER_TYPE_UNSPECIFIED' | 'MEMORY_LAYER_TYPE_EPISODIC' | 'MEMORY_LAYER_TYPE_SKILLS';
 }
 
 export interface MemoryLayerDeleteParams {
-  workspaceId: string;
+  workspaceId?: string;
 }
 
 MemoryLayers.Entries = Entries;
@@ -279,6 +300,8 @@ export declare namespace MemoryLayers {
     Entries as Entries,
     type MemoryEntry as MemoryEntry,
     type MemoryEntryCreateSpec as MemoryEntryCreateSpec,
+    type MemoryEntryCreateSpecContent as MemoryEntryCreateSpecContent,
+    type MemoryEntryCreateSpecUploadID as MemoryEntryCreateSpecUploadID,
     type MemoryEntryDetail as MemoryEntryDetail,
     type MemoryEntryInfo as MemoryEntryInfo,
     type MemoryEntrySpec as MemoryEntrySpec,

package/src/resources/models.ts

@@ -17,8 +17,12 @@ export class Models extends APIResource {
   /**
    * Retrieves a model by ID from the workspace
    */
-  retrieve(id: string, params: ModelRetrieveParams, options?: RequestOptions): APIPromise<Model> {
-    const { workspaceId } = params;
+  retrieve(
+    id: string,
+    params: ModelRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Model> {
+    const { workspaceId = this._client.workspaceID } = params ?? {};
     return this._client.get(path`/v1/workspaces/${workspaceId}/models/${id}`, options);
   }
 
@@ -26,11 +30,11 @@ export class Models extends APIResource {
    * Lists all models in the workspace
    */
   list(
-    workspaceID: string,
-    query: ModelListParams | null | undefined = {},
+    params: ModelListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<ModelsCursorPagination, Model> {
-    return this._client.getAPIList(path`/v1/workspaces/${workspaceID}/models`, CursorPagination<Model>, {
+    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
+    return this._client.getAPIList(path`/v1/workspaces/${workspaceId}/models`, CursorPagination<Model>, {
       query,
       ...options,
     });
@@ -41,7 +45,7 @@ export class Models extends APIResource {
    * provisioned on the model; use :swapModelOnVariations to move them first.
    */
   disable(id: string, params: ModelDisableParams, options?: RequestOptions): APIPromise<Model> {
-    const { workspaceId, ...body } = params;
+    const { workspaceId = this._client.workspaceID, ...body } = params;
     return this._client.post(path`/v1/workspaces/${workspaceId}/models/${id}:disable`, { body, ...options });
   }
 
@@ -50,7 +54,7 @@ export class Models extends APIResource {
    * in the workspace
    */
   enable(id: string, params: ModelEnableParams, options?: RequestOptions): APIPromise<Model> {
-    const { workspaceId, ...body } = params;
+    const { workspaceId = this._client.workspaceID, ...body } = params;
     return this._client.post(path`/v1/workspaces/${workspaceId}/models/${id}:enable`, { body, ...options });
   }
 
@@ -58,8 +62,9 @@ export class Models extends APIResource {
    * Reassigns agent variations from one model to another in bulk. Runs
    * asynchronously and returns immediately.
    */
-  swap(workspaceID: string, body: ModelSwapParams, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.post(path`/v1/workspaces/${workspaceID}/models:swapModelOnVariations`, {
+  swap(params: ModelSwapParams | null | undefined = {}, options?: RequestOptions): APIPromise<unknown> {
+    const { workspaceId = this._client.workspaceID, ...body } = params ?? {};
+    return this._client.post(path`/v1/workspaces/${workspaceId}/models:swapModelOnVariations`, {
       body,
       ...options,
     });
@@ -121,7 +126,12 @@ export interface ModelSpec {
   /**
    * The model family (e.g., "claude-sonnet-4.6", "gpt-5.4", "gemini-2.5-flash")
    */
-  family?: string;
+  family: string;
+
+  /**
+   * The model provider (e.g., "anthropic", "openai", "google")
+   */
+  provider: string;
 
   /**
    * Cost per million input tokens in cents (e.g., 300 = $3.00)
@@ -142,11 +152,6 @@ export interface ModelSpec {
    * Cost per million output tokens in cents (e.g., 1500 = $15.00)
    */
   outputPricePerMillionTokens?: string;
-
-  /**
-   * The model provider (e.g., "anthropic", "openai", "google")
-   */
-  provider?: string;
 }
 
 /**
@@ -159,55 +164,60 @@ export interface ModelRetrieveParams {
   /**
    * Workspace ID.
    */
-  workspaceId: string;
+  workspaceId?: string;
 }
 
 export interface ModelListParams extends CursorPaginationParams {
   /**
-   * Filter to models provisioned on a specific AI provider key. Accepts the key's id
-   * or an "external_id:"-prefixed slug.
+   * Path param: Workspace ID.
+   */
+  workspaceId?: string;
+
+  /**
+   * Query param: Filter to models provisioned on a specific AI provider key. Accepts
+   * the key's id or an "external_id:"-prefixed slug.
    */
   aiProviderKeyId?: string;
 
   /**
-   * When true, populate each item's info (e.g. the AI provider), at the cost of
-   * extra lookups.
+   * Query param: When true, populate each item's info (e.g. the AI provider), at the
+   * cost of extra lookups.
    */
   includeInfo?: boolean;
 
   /**
-   * Filter models to only ones assigned to an active agent variation/agent. Draft
-   * agents count as assigned; archived agents do not. Assignment does not imply
-   * recent traffic — see ModelInfo.last_used_at for that.
+   * Query param: Filter models to only ones assigned to an active agent
+   * variation/agent. Draft agents count as assigned; archived agents do not.
+   * Assignment does not imply recent traffic — see ModelInfo.last_used_at for that.
    */
   isAssigned?: boolean;
 
   /**
-   * Filters by metadata labels. Comma-separated key=value pairs, e.g.
+   * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
    * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
    * semantics).
    */
   labels?: string;
 
   /**
-   * Filter by a prefix of the model's display name, external id, or id
+   * Query param: Filter by a prefix of the model's display name, external id, or id
    * (case-insensitive). A model's external id is the form used in
    * modelConfig.modelId, so a caller holding that can narrow the list by it.
    */
   prefix?: string;
 
   /**
-   * Free-form search query
+   * Query param: Free-form search query
    */
   query?: string;
 
   /**
-   * Sort order for results (asc or desc by creation time)
+   * Query param: Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
 
   /**
-   * Filter by model state
+   * Query param: Filter by model state
    */
   state?: 'STATE_UNSPECIFIED' | 'STATE_ENABLED' | 'STATE_DISABLED';
 }
@@ -216,19 +226,24 @@ export interface ModelDisableParams {
   /**
    * Workspace ID.
    */
-  workspaceId: string;
+  workspaceId?: string;
 }
 
 export interface ModelEnableParams {
   /**
    * Workspace ID.
    */
-  workspaceId: string;
+  workspaceId?: string;
 }
 
 export interface ModelSwapParams {
   /**
-   * The swaps to perform.
+   * Path param: Workspace ID.
+   */
+  workspaceId?: string;
+
+  /**
+   * Body param: The swaps to perform.
    */
   modelSwaps?: Array<ModelSwapParams.ModelSwap>;
 }