@engini/client 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -320,7 +320,7 @@ type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
 type Options$1<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
 
 type ClientOptions = {
-    baseUrl: 'https://feat-public-api.staging.engini.io/api' | (string & {});
+    baseUrl: 'https://api.staging.engini.io' | (string & {});
 };
 /**
  * Identity of the principal a Developer API request is authenticated as, returned by
@@ -1073,77 +1073,25 @@ type UninstallSolutionRequest = {
      */
     deleteTables: boolean;
 };
-/**
- * Offset-based paginated wrapper for a list of items.
- */
 type PaginatedResponseOfApplicationDto = {
-    /**
-     * The items in the current page.
-     */
     items: Array<ApplicationDto>;
-    /**
-     * Total number of items available across all pages.
-     */
     totalCount: number;
-    /**
-     * Number of items skipped before this page (the requested offset).
-     */
     offset: number;
-    /**
-     * Maximum number of items requested for this page.
-     */
     top: number;
 };
-/**
- * Public Developer API v1 representation of an Application.
- * Returned by GET /api/DeveloperAPI/v1/applications.
- */
 type ApplicationDto = {
-    /**
-     * Stable public slug identifying the application.
-     */
     slug: string;
-    /**
-     * Human-readable display name of the application.
-     */
     applicationName?: string | null;
-    /**
-     * Description of what the application does.
-     */
     description: string;
-    /**
-     * URL of the application's logo image.
-     */
     applicationLogo?: string | null;
-    /**
-     * Whether and how a connection is required to use this application.
-     */
     connectionRequirement: string;
-    /**
-     * Categories the application belongs to.
-     */
     categories: Array<string>;
-    /**
-     * Number of tools (activities) the application exposes.
-     */
     toolsCount: number;
-    /**
-     * Number of triggers the application exposes.
-     */
     triggersCount: number;
 };
 type ApplicationDetailDto = ApplicationDto & {
-    /**
-     * Whether the application supports selecting specific objects for a connection.
-     */
     supportsObjectSelection?: boolean;
-    /**
-     * URL of help/documentation for the application.
-     */
     helpUrl?: string | null;
-    /**
-     * Authentication methods supported by the application.
-     */
     authenticationMethods?: Array<ApplicationAuthMethod>;
 };
 type ApplicationAuthMethod = {
@@ -1154,6 +1102,7 @@ type ApplicationAuthMethod = {
     connectionFields: Array<ApplicationConnectionField>;
     requiresOAuthSignIn: boolean;
     oAuthProvider?: string | null;
+    isDefault: boolean;
 };
 type ApplicationConnectionField = {
     fieldName: string;
@@ -1167,300 +1116,97 @@ type ApplicationConnectionField = {
     tooltip?: string | null;
     placeholder?: string | null;
     listValues?: string | null;
-    /**
-     * When true, callers can supply this field's value per-execution via the
-     * `customConnectionData` array on POST /tools/{toolSlug}/execute. Mirrors
-     * AppConnectionField.AllowOverride.
-     */
     allowOverride: boolean;
 };
 type AppConnectionFieldInputType = 0 | 1 | 2 | 3;
-/**
- * Offset-based paginated wrapper for a list of items.
- */
 type PaginatedResponseOfConnectionPublicListItem = {
-    /**
-     * The items in the current page.
-     */
     items: Array<ConnectionPublicListItem>;
-    /**
-     * Total number of items available across all pages.
-     */
     totalCount: number;
-    /**
-     * Number of items skipped before this page (the requested offset).
-     */
     offset: number;
-    /**
-     * Maximum number of items requested for this page.
-     */
     top: number;
 };
-/**
- * Public-shape list item for /api/DeveloperAPI/v1/Connections.
- * Applications are identified by slug only (no ApplicationId in the wire response).
- * Internal queries continue to use ConnectionList which carries both.
- */
 type ConnectionPublicListItem = {
-    /**
-     * Identifier of the connection.
-     */
     connectionId: number;
-    /**
-     * Display name of the connection.
-     */
     connectionName: string;
-    /**
-     * Description of the connection.
-     */
     description?: string | null;
-    /**
-     * Slug of the connection's application.
-     */
     applicationSlug: string;
-    /**
-     * Display name of the connection's application.
-     */
     applicationName?: string | null;
-    /**
-     * URL of the application's logo image.
-     */
     applicationLogo?: string | null;
-    /**
-     * Whether the connection is shared/public.
-     */
     isPublic: boolean;
-    /**
-     * Identifier of the user who created the connection.
-     */
     createdBy: string;
-    /**
-     * When the connection was created.
-     */
     createdDate: string;
-    /**
-     * Identifier of the user who last updated the connection; null if never updated.
-     */
     updatedBy?: string | null;
-    /**
-     * When the connection was last updated; null if never updated.
-     */
     updatedDate?: string | null;
 };
 type ConnectionPublicDetail = ConnectionPublicListItem & {
-    /**
-     * Identifier of the authentication method used by the connection.
-     */
     authenticationId?: number;
-    /**
-     * Name of the authentication type used by the connection.
-     */
     authenticationType?: string;
-    /**
-     * Connection field values, keyed by field name (sensitive values may be masked).
-     */
     fields?: {
         [key: string]: string | null;
     };
-    /**
-     * Whether the connection uses selected database objects.
-     */
     useSelectDBObjects?: boolean;
-    /**
-     * Last connection error message, if any.
-     */
     connectionError?: string | null;
-    /**
-     * Whether the connection is currently healthy/reachable.
-     */
     isAlive?: boolean;
-    /**
-     * Additional connection metadata, keyed by name.
-     */
     metadata?: {
         [key: string]: string;
     } | null;
 };
-/**
- * Request body for creating a connection.
- */
 type CreateConnectionRequest = {
-    /**
-     * Slug of the application to connect to.
-     */
     applicationSlug: string;
-    /**
-     * Display name for the new connection.
-     */
     connectionName: string;
-    /**
-     * Optional description of the connection.
-     */
     description?: string | null;
-    /**
-     * Identifier of the authentication method to use.
-     */
-    authenticationId: number;
-    /**
-     * Connection field values, keyed by field name.
-     */
+    authenticationId?: number | null;
     fields: {
         [key: string]: string;
     };
-    /**
-     * Optional additional connection metadata, keyed by name.
-     */
     metadata?: {
         [key: string]: string;
     } | null;
 };
-/**
- * Request body for updating a connection; null members are left unchanged.
- */
 type UpdateConnectionRequest = {
-    /**
-     * New display name; null leaves it unchanged.
-     */
     connectionName?: string | null;
-    /**
-     * New description; null leaves it unchanged.
-     */
     description?: string | null;
-    /**
-     * Connection field values to update, keyed by field name; null leaves them unchanged.
-     */
     fields?: {
         [key: string]: string;
     } | null;
-    /**
-     * Metadata to update, keyed by name; null leaves it unchanged.
-     */
     metadata?: {
         [key: string]: string;
     } | null;
 };
-/**
- * Response listing the caller's default connection per application.
- */
 type DefaultConnectionsResponse = {
-    /**
-     * The default-connection entries, one per application.
-     */
     items: Array<DefaultConnectionDto>;
 };
-/**
- * Per-(account-user, application) default-connection responses for the
- * /connections/defaults endpoints. See toolsets-and-connections-spec.md.
- */
 type DefaultConnectionDto = {
-    /**
-     * Slug of the application this default applies to.
-     */
     applicationSlug: string;
-    /**
-     * Display name of the application.
-     */
     applicationName?: string | null;
-    /**
-     * Identifier of the default connection (Connector ID).
-     */
     connectionId: number;
-    /**
-     * Display name of the default connection.
-     */
     connectionName?: string | null;
 };
-/**
- * Response confirming a connection was set as the default for an application.
- */
 type SetDefaultConnectionResponse = {
-    /**
-     * Slug of the application the default was set for.
-     */
     applicationSlug: string;
-    /**
-     * Identifier of the connection set as default.
-     */
     connectionId: number;
-    /**
-     * Whether the connection is now the default (always true).
-     */
     isDefault: boolean;
 };
-/**
- * Request body for replacing a connection used by a workflow.
- */
 type ReplaceConnectionRequest = {
-    /**
-     * Identifier of the workflow whose connection is being replaced.
-     */
     workflowId: number;
-    /**
-     * Identifier of the connection currently used by the workflow.
-     */
     originalConnectionId: number;
-    /**
-     * Identifier of the connection to use instead.
-     */
     newConnectionId: number;
 };
-/**
- * Status of a connection's most recent metadata/object refresh.
- */
 type RefreshStatusResponse = {
-    /**
-     * Current refresh status.
-     */
     status: RefreshStatus;
-    /**
-     * Human-readable description of the current status.
-     */
     statusDescription?: string | null;
-    /**
-     * Error message from the last failed refresh, if any.
-     */
     error?: string | null;
-    /**
-     * When the last error occurred, if any.
-     */
     errorDate?: string | null;
-    /**
-     * When the connection was last refreshed successfully.
-     */
     lastRefreshDate?: string | null;
 };
-/**
- * Possible states of a connection refresh.
- */
 type RefreshStatus = 0 | 1 | 2;
-/**
- * Request body for selecting which objects a connection exposes.
- */
 type SelectObjectsRequest = {
-    /**
-     * Identifiers of the objects to select for the connection.
-     */
     objectIds: Array<number>;
 };
-/**
- * Offset-based paginated wrapper for a list of items.
- */
 type PaginatedResponseOfConnectionObject = {
-    /**
-     * The items in the current page.
-     */
     items: Array<ConnectionObject>;
-    /**
-     * Total number of items available across all pages.
-     */
     totalCount: number;
-    /**
-     * Number of items skipped before this page (the requested offset).
-     */
     offset: number;
-    /**
-     * Maximum number of items requested for this page.
-     */
     top: number;
 };
 type ConnectionObject = {
@@ -1469,38 +1215,14 @@ type ConnectionObject = {
     type: string;
     isSelected: boolean;
 };
-/**
- * Response containing a generated OAuth sign-in URL.
- */
 type SignInUrlResponse = {
-    /**
-     * The URL the user should visit to authenticate.
-     */
     signInUrl: string;
-    /**
-     * Opaque state value tying the sign-in flow back to the request.
-     */
     state: string;
 };
-/**
- * Request body for generating an OAuth sign-in URL.
- */
 type SignInUrlRequest = {
-    /**
-     * Slug of the application to authenticate against.
-     */
     applicationSlug: string;
-    /**
-     * Identifier of the authentication method to use.
-     */
     authenticationId: number;
-    /**
-     * Optional environment to target for sign-in.
-     */
     environment?: string | null;
-    /**
-     * Optional field values required to build the sign-in URL, keyed by field name.
-     */
     fields?: {
         [key: string]: string;
     } | null;
@@ -1515,192 +1237,58 @@ type AccessTokenResponse = {
         [key: string]: unknown;
     };
 };
-/**
- * Offset-based paginated wrapper for a list of items.
- */
 type PaginatedResponseOfToolDto = {
-    /**
-     * The items in the current page.
-     */
     items: Array<ToolDto>;
-    /**
-     * Total number of items available across all pages.
-     */
     totalCount: number;
-    /**
-     * Number of items skipped before this page (the requested offset).
-     */
     offset: number;
-    /**
-     * Maximum number of items requested for this page.
-     */
     top: number;
 };
-/**
- * Public Developer API v1 representation of a tool (Activity).
- * Returned by GET /api/DeveloperAPI/v1/tools.
- */
 type ToolDto = {
-    /**
-     * Public identifier, sourced from Activity.McpToolName.
-     */
     toolSlug: string;
-    /**
-     * Human-readable display name of the tool.
-     */
     toolName?: string | null;
-    /**
-     * Description of what the tool does.
-     */
     description?: string | null;
-    /**
-     * Category the tool belongs to.
-     */
     category: string;
-    /**
-     * Slug of the application this tool belongs to.
-     */
     applicationSlug: string;
-    /**
-     * Display name of the application this tool belongs to.
-     */
     applicationName?: string | null;
-    /**
-     * Version of the tool.
-     */
     version?: string | null;
-    /**
-     * Whether the tool is deprecated.
-     */
     isDeprecated: boolean;
 };
 type ToolDetailDto = ToolDto & {
-    /**
-     * JSON Schema describing the tool's input fields.
-     */
     inputSchema?: unknown;
-    /**
-     * JSON Schema describing the tool's output shape.
-     */
     outputSchema?: unknown;
-    /**
-     * Whether the tool supports filter conditions on execution.
-     */
     supportsFilters?: boolean;
-    /**
-     * Whether the tool supports sort ordering on execution.
-     */
     supportsSort?: boolean;
-    /**
-     * Whether the tool supports top/offset pagination on execution.
-     */
     supportsTopOffset?: boolean;
-    /**
-     * Maximum number of filter conditions allowed per execution.
-     */
     maxFilters?: number;
-    /**
-     * Maximum number of sort clauses allowed per execution.
-     */
     maxSorts?: number;
 };
-/**
- * 200 response shape for POST /api/DeveloperAPI/v1/tools/{toolSlug}/execute.
- * Tool-runtime failures (downstream API errors) return 200 + IsSuccess=false
- * + ErrorMessage — not the standard error envelope. All non-200 responses use
- * the standard ErrorResponse envelope, not this type.
- * See applications-tools-spec.md §"Response 200".
- */
 type ToolExecuteResponse = {
-    /**
-     * Whether the tool executed successfully. When false, see ErrorMessage.
-     */
     isSuccess: boolean;
-    /**
-     * Human-readable failure reason when IsSuccess is false; otherwise null.
-     */
     errorMessage?: string | null;
-    /**
-     * Metadata about the execution (HTTP status, headers, timing, payload size).
-     */
     executionInfo?: ExecutionInfo | null;
-    /**
-     * The tool's result payload. Intentionally free-form (any JSON): its shape is defined by the
-     * individual tool's output schema, not by this envelope (api-spec-feedback.md C3).
-     */
     output?: unknown;
-    /**
-     * Identifier of the workflow-history record for this execution, when one was created.
-     */
     historyId?: number | null;
 };
-/**
- * Metadata about a tool execution (downstream HTTP status, headers, timing, payload size).
- */
 type ExecutionInfo = {
-    /**
-     * HTTP status code returned by the downstream call.
-     */
     statusCode?: number | null;
-    /**
-     * Response headers from the downstream call, keyed by header name.
-     */
     headers?: {
         [key: string]: string;
     } | null;
-    /**
-     * Execution time in milliseconds.
-     */
     executionTime?: number | null;
-    /**
-     * Size of the response payload in bytes.
-     */
     dataSize?: number | null;
 };
-/**
- * Body shape for POST /api/DeveloperAPI/v1/tools/{toolSlug}/execute.
- * activityName is intentionally absent — the activity is resolved from the
- * path slug (+ optional ?applicationSlug=). Connection is resolved implicitly
- * from the caller's account-user, the tool's parent application, and the
- * optional ?toolsetId= query param. See applications-tools-spec.md §"POST
- * /api/DeveloperAPI/v1/tools/{toolSlug}/execute".
- */
 type ToolExecuteRequest = {
-    /**
-     * Input field values for the tool, keyed by field name.
-     */
     fields?: {
         [key: string]: unknown;
     } | null;
-    /**
-     * Optional context value passed to the tool.
-     */
     contextValue?: string | null;
-    /**
-     * Filter conditions to apply to the tool's results.
-     */
     filters?: Array<ActivityCondition> | null;
-    /**
-     * Sort clauses to apply to the tool's results.
-     */
     sort?: Array<ActivitySort> | null;
-    /**
-     * Number of leading results to skip (pagination offset).
-     */
     offset?: number | null;
-    /**
-     * Maximum number of results to return.
-     */
     top?: number | null;
-    /**
-     * Sub-item input values for the tool, keyed by name.
-     */
     subItems?: {
         [key: string]: unknown;
     } | null;
-    /**
-     * Per-call overrides for the resolved connection's fields; only fields marked overridable are accepted.
-     */
     customConnectionData?: Array<CustomConnectionDataItem> | null;
 };
 type ActivityCondition = {
@@ -1713,155 +1301,45 @@ type ActivitySort = {
     orderDirection: OrderDirection;
 };
 type OrderDirection = 1 | -1;
-/**
- * A single per-call override of a connection field value.
- */
 type CustomConnectionDataItem = {
-    /**
-     * Name of the connection field to override.
-     */
     fieldName: string;
-    /**
-     * Override value for the field.
-     */
     value: string;
 };
-/**
- * Offset-based paginated wrapper for a list of items.
- */
 type PaginatedResponseOfToolsetDto = {
-    /**
-     * The items in the current page.
-     */
     items: Array<ToolsetDto>;
-    /**
-     * Total number of items available across all pages.
-     */
     totalCount: number;
-    /**
-     * Number of items skipped before this page (the requested offset).
-     */
     offset: number;
-    /**
-     * Maximum number of items requested for this page.
-     */
     top: number;
 };
-/**
- * Public-shape DTO for a toolset (per-account-user, named scope bundling specific
- * connections + an allowed tool set). See toolsets-and-connections-spec.md.
- */
 type ToolsetDto = {
-    /**
-     * Unique identifier of the toolset (the MCPServer token GUID).
-     */
     toolsetId: string;
-    /**
-     * Display name of the toolset.
-     */
     name: string;
-    /**
-     * Connections included in this toolset and their permitted tools.
-     */
     connections: Array<ToolsetConnectionDto>;
-    /**
-     * Workflow token GUIDs included in this toolset.
-     */
     workflows: Array<string>;
-    /**
-     * When the toolset was created.
-     */
     createdDate: string;
-    /**
-     * When the toolset was last updated; null if never updated.
-     */
     updatedDate?: string | null;
-    /**
-     * Account-user ID that created the toolset.
-     */
     createdByAccountUserId?: number | null;
-    /**
-     * Account-user ID that last updated the toolset; null/0 until first updated.
-     */
     updatedByAccountUserId?: number | null;
 };
-/**
- * A connection within a toolset, scoped to a set of permitted tools.
- */
 type ToolsetConnectionDto = {
-    /**
-     * Identifier of the connection (Connector ID).
-     */
     connectionId: number;
-    /**
-     * Slug of the connection's application.
-     */
     applicationSlug: string;
-    /**
-     * Display name of the connection's application.
-     */
     applicationName?: string | null;
-    /**
-     * Tool slugs permitted for this connection; empty means all tools of the app are permitted.
-     */
     toolSlugs: Array<string>;
 };
-/**
- * Request body for creating a toolset.
- */
 type CreateToolsetRequest = {
-    /**
-     * Display name for the new toolset.
-     */
     name: string;
-    /**
-     * Connections to include in the toolset and their permitted tools.
-     */
     connections: Array<ToolsetConnectionRequest>;
-    /**
-     * Workflow token GUIDs to include in the toolset.
-     */
     workflows?: Array<string> | null;
 };
-/**
- * A connection entry in a create/update toolset request.
- */
 type ToolsetConnectionRequest = {
-    /**
-     * Optional connection identifier (Connector ID). Omit it to let the backend pick the
-     * caller's default connection for the application of the listed tools (resolved and
-     * stored as a concrete id at save time); when omitted, ToolSlugs must list
-     * at least one tool so the application can be determined.
-     */
     connectionId?: number | null;
-    /**
-     * Optional application slug. When ConnectionId is omitted, supply this to
-     * scope the entry to a whole application (all its tools) using the caller's default
-     * connection for that app — resolved and stored as a concrete connectionId at save time.
-     * An alternative to listing tool slugs; if both are supplied, applicationSlug is
-     * authoritative for the application.
-     */
     applicationSlug?: string | null;
-    /**
-     * Tool slugs to permit for this connection; omit/empty to permit all tools of the app. When ConnectionId is omitted, supply either applicationSlug or at least one tool slug.
-     */
     toolSlugs?: Array<string> | null;
 };
-/**
- * Request body for updating a toolset; null members are left unchanged.
- */
 type UpdateToolsetRequest = {
-    /**
-     * New display name; null leaves it unchanged.
-     */
     name?: string | null;
-    /**
-     * Replacement connection set; null leaves it unchanged.
-     */
     connections?: Array<ToolsetConnectionRequest> | null;
-    /**
-     * Replacement workflow set; null leaves it unchanged.
-     */
     workflows?: Array<string> | null;
 };
 type AuthWhoAmIData = {
@@ -1878,24 +1356,27 @@ type AuthWhoAmIData = {
 };
 type AuthWhoAmIErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -1914,7 +1395,7 @@ type SolutionsCreateSolutionData = {
     body: CreateSolutionRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -1923,22 +1404,28 @@ type SolutionsCreateSolutionData = {
     url: '/v1/solutions/admin';
 };
 type SolutionsCreateSolutionErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -1969,21 +1456,27 @@ type SolutionsArchiveSolutionData = {
 };
 type SolutionsArchiveSolutionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2002,7 +1495,7 @@ type SolutionsUpdateSolutionData = {
     body: UpdateSolutionRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2016,19 +1509,28 @@ type SolutionsUpdateSolutionData = {
     url: '/v1/solutions/admin/{slug}';
 };
 type SolutionsUpdateSolutionErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2058,19 +1560,28 @@ type SolutionsPublishSolutionData = {
     url: '/v1/solutions/admin/{slug}/publish';
 };
 type SolutionsPublishSolutionErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2089,7 +1600,7 @@ type SolutionsBuildManifestData = {
     body: BuildManifestRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2098,19 +1609,28 @@ type SolutionsBuildManifestData = {
     url: '/v1/solutions/admin/build-manifest';
 };
 type SolutionsBuildManifestErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2149,27 +1669,27 @@ type SolutionsGetPublishedSolutionsData = {
 };
 type SolutionsGetPublishedSolutionsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2200,24 +1720,27 @@ type SolutionsGetSolutionBySlugData = {
 };
 type SolutionsGetSolutionBySlugErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2233,7 +1756,7 @@ type SolutionsGetInstallationsData = {
     body?: never;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2251,25 +1774,28 @@ type SolutionsGetInstallationsData = {
     url: '/v1/solutions/installations';
 };
 type SolutionsGetInstallationsErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2285,7 +1811,7 @@ type SolutionsGetInstallationDetailData = {
     body?: never;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2299,22 +1825,28 @@ type SolutionsGetInstallationDetailData = {
     url: '/v1/solutions/installations/{id}';
 };
 type SolutionsGetInstallationDetailErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2330,7 +1862,7 @@ type SolutionsGetInstallationResourcesData = {
     body?: never;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2353,22 +1885,28 @@ type SolutionsGetInstallationResourcesData = {
     url: '/v1/solutions/installations/{id}/resources';
 };
 type SolutionsGetInstallationResourcesErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2387,7 +1925,7 @@ type SolutionsInstallSolutionData = {
     body: InstallSolutionRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2401,20 +1939,32 @@ type SolutionsInstallSolutionData = {
     url: '/v1/solutions/{slug}/install';
 };
 type SolutionsInstallSolutionErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
+    /**
+     * Conflict - the solution is already installed in this workspace.
+     */
     409: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2433,7 +1983,7 @@ type SolutionsUpdateInstallationData = {
     body?: UpdateInstallationRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2447,23 +1997,32 @@ type SolutionsUpdateInstallationData = {
     url: '/v1/solutions/installations/{id}/update';
 };
 type SolutionsUpdateInstallationErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
+    /**
+     * Conflict - the update is blocked by one or more conditions, returned in the response body; retry with forceModify=true to proceed anyway.
+     */
     409: UpdateBlockedResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2482,7 +2041,7 @@ type SolutionsUninstallSolutionData = {
     body: UninstallSolutionRequest;
     headers?: {
         /**
-         * Account token. The server resolves the account token from this header OR from the `AccountToken` claim on the Bearer JWT - either alone is sufficient. OAuth-issued JWTs include the claim automatically; password sign-in JWTs do not. If both are sent, the header wins.
+         * Optional account-scoping header. Alternative to a claim carried on the Bearer JWT.
          */
         companytoken?: string;
     };
@@ -2496,22 +2055,28 @@ type SolutionsUninstallSolutionData = {
     url: '/v1/solutions/{slug}/uninstall';
 };
 type SolutionsUninstallSolutionErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2565,22 +2130,28 @@ type ApplicationsListApplicationsData = {
     url: '/v1/applications';
 };
 type ApplicationsListApplicationsErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2611,21 +2182,27 @@ type ApplicationsGetApplicationData = {
 };
 type ApplicationsGetApplicationErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2674,27 +2251,27 @@ type ConnectionsGetConnectionsData = {
 };
 type ConnectionsGetConnectionsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2723,27 +2300,27 @@ type ConnectionsCreateConnectionData = {
 };
 type ConnectionsCreateConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2774,27 +2351,27 @@ type ConnectionsDeleteConnectionData = {
 };
 type ConnectionsDeleteConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2825,27 +2402,27 @@ type ConnectionsGetConnectionData = {
 };
 type ConnectionsGetConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2879,27 +2456,27 @@ type ConnectionsUpdateConnectionData = {
 };
 type ConnectionsUpdateConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2921,31 +2498,31 @@ type ConnectionsGetDefaultConnectionsData = {
     };
     path?: never;
     query?: never;
-    url: '/v1/connections/Defaults';
+    url: '/v1/connections/defaults';
 };
 type ConnectionsGetDefaultConnectionsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -2972,31 +2549,31 @@ type ConnectionsClearDefaultConnectionData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/Default';
+    url: '/v1/connections/{connectionId}/default';
 };
 type ConnectionsClearDefaultConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3023,31 +2600,31 @@ type ConnectionsSetDefaultConnectionData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/Default';
+    url: '/v1/connections/{connectionId}/default';
 };
 type ConnectionsSetDefaultConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3072,31 +2649,31 @@ type ConnectionsReplaceConnectionData = {
     };
     path?: never;
     query?: never;
-    url: '/v1/connections/Replace';
+    url: '/v1/connections/replace';
 };
 type ConnectionsReplaceConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3123,31 +2700,31 @@ type ConnectionsRefreshObjectsData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/RefreshObjects';
+    url: '/v1/connections/{connectionId}/refresh-objects';
 };
 type ConnectionsRefreshObjectsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3174,31 +2751,31 @@ type ConnectionsGetRefreshStatusData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/RefreshStatus';
+    url: '/v1/connections/{connectionId}/refresh-status';
 };
 type ConnectionsGetRefreshStatusErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3228,31 +2805,31 @@ type ConnectionsSelectObjectsData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/SelectObjects';
+    url: '/v1/connections/{connectionId}/select-objects';
 };
 type ConnectionsSelectObjectsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3296,31 +2873,31 @@ type ConnectionsGetConnectionObjectsData = {
          */
         top?: number;
     };
-    url: '/v1/connections/{connectionId}/Objects';
+    url: '/v1/connections/{connectionId}/objects';
 };
 type ConnectionsGetConnectionObjectsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3347,31 +2924,31 @@ type ConnectionsCheckConnectionData = {
         connectionId: number;
     };
     query?: never;
-    url: '/v1/connections/{connectionId}/Check';
+    url: '/v1/connections/{connectionId}/check';
 };
 type ConnectionsCheckConnectionErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3396,31 +2973,31 @@ type ConnectionsGetSignInUrlData = {
     };
     path?: never;
     query?: never;
-    url: '/v1/connections/GetSignInUrl';
+    url: '/v1/connections/get-sign-in-url';
 };
 type ConnectionsGetSignInUrlErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3447,31 +3024,31 @@ type ConnectionsGetAccessTokenData = {
         state: string;
     };
     query?: never;
-    url: '/v1/connections/AccessToken/{state}';
+    url: '/v1/connections/access-token/{state}';
 };
 type ConnectionsGetAccessTokenErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3533,22 +3110,28 @@ type ToolsListToolsData = {
     url: '/v1/tools';
 };
 type ToolsListToolsErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3587,19 +3170,28 @@ type ToolsGetToolData = {
     url: '/v1/tools/{toolSlug}';
 };
 type ToolsGetToolErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3641,17 +3233,32 @@ type ToolsExecuteToolData = {
     url: '/v1/tools/{toolSlug}/execute';
 };
 type ToolsExecuteToolErrors = {
+    /**
+     * Bad request - malformed body or invalid parameters.
+     */
     400: ErrorResponse;
+    /**
+     * Unauthorized - missing or invalid bearer token.
+     */
     401: ErrorResponse;
+    /**
+     * Forbidden - the caller lacks access to the resource.
+     */
     403: ErrorResponse;
+    /**
+     * Not found - the resource does not exist.
+     */
     404: ErrorResponse;
+    /**
+     * Conflict - the tool has no resolvable connection: either the supplied toolset has no connection for the tool's application (NO_TOOLSET_CONNECTION), or the caller has no default connection configured and none can be resolved (NO_DEFAULT_CONNECTION).
+     */
     409: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3686,27 +3293,27 @@ type ToolsetsListToolsetsData = {
 };
 type ToolsetsListToolsetsErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3735,27 +3342,27 @@ type ToolsetsCreateToolsetData = {
 };
 type ToolsetsCreateToolsetErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3786,27 +3393,27 @@ type ToolsetsDeleteToolsetData = {
 };
 type ToolsetsDeleteToolsetErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3837,27 +3444,27 @@ type ToolsetsGetToolsetData = {
 };
 type ToolsetsGetToolsetErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3891,27 +3498,27 @@ type ToolsetsUpdateToolsetData = {
 };
 type ToolsetsUpdateToolsetErrors = {
     /**
-     * Bad request — malformed body or invalid parameters.
+     * Bad request - malformed body or invalid parameters.
      */
     400: ErrorResponse;
     /**
-     * Unauthorized — missing or invalid bearer token.
+     * Unauthorized - missing or invalid bearer token.
      */
     401: ErrorResponse;
     /**
-     * Forbidden — the caller lacks access to the resource.
+     * Forbidden - the caller lacks access to the resource.
      */
     403: ErrorResponse;
     /**
-     * Not found — the resource does not exist.
+     * Not found - the resource does not exist.
      */
     404: ErrorResponse;
     /**
-     * Too many requests — rate limit exceeded.
+     * Too many requests - rate limit exceeded.
      */
     429: ErrorResponse;
     /**
-     * Internal server error — an unexpected error occurred.
+     * Internal server error - an unexpected error occurred.
      */
     500: ErrorResponse;
 };
@@ -3938,9 +3545,15 @@ type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean
     meta?: Record<string, unknown>;
 };
 /**
+ * Get the caller's identity.
+ *
  * Returns the identity of the principal the request is authenticated as: full name, email,
- * current company, role, and caller type. For x-api-key requests the identity is the
- * token's owner (the key acts as the owner) and the type is reported as apiuser.
+ * current company, role, and caller type (userType). For an x-api-key request
+ * the identity returned is the key's owner (the key acts as the owner) and userType is
+ * reported as apiuser; a hard-deleted (anonymized) profile is reported as
+ * anonymous; every other caller is user. Fields resolved from the current
+ * company/role (currentCompany, role) are null when no company context could
+ * be resolved for the caller.
  */
 declare const authWhoAmI: <ThrowOnError extends boolean = false>(options?: Options<AuthWhoAmIData, ThrowOnError>) => RequestResult<AuthWhoAmIResponses, AuthWhoAmIErrors, ThrowOnError>;
 /**
@@ -4006,110 +3619,238 @@ declare const solutionsUpdateInstallation: <ThrowOnError extends boolean = false
  */
 declare const solutionsUninstallSolution: <ThrowOnError extends boolean = false>(options: Options<SolutionsUninstallSolutionData, ThrowOnError>) => RequestResult<SolutionsUninstallSolutionResponses, SolutionsUninstallSolutionErrors, ThrowOnError>;
 /**
- * List the applications available to the caller, with optional filtering and pagination.
+ * List applications.
+ *
+ * Returns the applications the caller's account can browse, honoring the optional filters
+ * and pagination. Set available=true to restrict results to applications the caller
+ * can currently use - i.e. their connection requirement is already satisfied - otherwise the
+ * full catalog is returned regardless of connection state. Account context is resolved from
+ * the caller's authenticated account / API key.
  */
 declare const applicationsListApplications: <ThrowOnError extends boolean = false>(options?: Options<ApplicationsListApplicationsData, ThrowOnError>) => RequestResult<ApplicationsListApplicationsResponses, ApplicationsListApplicationsErrors, ThrowOnError>;
 /**
- * Get the full details of a single application identified by its slug.
+ * Get an application.
+ *
+ * Fetches the full detail record for a single application by slug, including its connection
+ * requirement and the authentication methods it supports. Returns 404 if no application
+ * exists with the given slug for the caller's account.
  */
 declare const applicationsGetApplication: <ThrowOnError extends boolean = false>(options: Options<ApplicationsGetApplicationData, ThrowOnError>) => RequestResult<ApplicationsGetApplicationResponses, ApplicationsGetApplicationErrors, ThrowOnError>;
 /**
- * List the connections available to the caller, with optional filtering and pagination.
+ * List connections.
+ *
+ * Returns the connections owned by the caller's account, honoring the optional filters
+ * and pagination. top is silently clamped to the range 1-100 (default 25) and a
+ * negative offset is treated as 0. The optional metadata filter matches on
+ * the connection's stored metadata key/value pairs.
  */
 declare const connectionsGetConnections: <ThrowOnError extends boolean = false>(options?: Options<ConnectionsGetConnectionsData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionsResponses, ConnectionsGetConnectionsErrors, ThrowOnError>;
 /**
- * Create a new connection for the caller.
+ * Create a connection.
+ *
+ * Creates a new connection for the caller's account using the given field values (e.g.
+ * API key, credentials) for the target application. authenticationId selects which
+ * of the application's authentication methods to use; omit it to use the application's
+ * default. To connect via OAuth instead of directly supplying credentials, use
+ * POST /connections/get-sign-in-url followed by
+ * GET /connections/access-token/{state}.
  */
 declare const connectionsCreateConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsCreateConnectionData, ThrowOnError>) => RequestResult<ConnectionsCreateConnectionResponses, ConnectionsCreateConnectionErrors, ThrowOnError>;
 /**
- * Delete a connection owned by the caller.
+ * Delete a connection.
+ *
+ * Permanently deletes a connection owned by the caller's account. A public (shared)
+ * connection cannot be deleted via this endpoint. Any toolsets referencing this
+ * connection are updated as part of the deletion.
  */
 declare const connectionsDeleteConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsDeleteConnectionData, ThrowOnError>) => RequestResult<ConnectionsDeleteConnectionResponses, ConnectionsDeleteConnectionErrors, ThrowOnError>;
 /**
- * Get the full details of a single connection identified by its id.
+ * Get a connection.
+ *
+ * Fetches the full detail record for a single connection owned by the caller's account,
+ * including its field values and metadata.
  */
 declare const connectionsGetConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetConnectionData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionResponses, ConnectionsGetConnectionErrors, ThrowOnError>;
 /**
- * Update an existing connection owned by the caller.
+ * Update a connection.
+ *
+ * Updates a connection owned by the caller's account. Only the fields present in the
+ * request body are changed; connectionName, description, fields, and
+ * metadata are each left unchanged when omitted (null). Supplying fields or
+ * metadata replaces the entire map, it does not merge with the existing one.
  */
 declare const connectionsUpdateConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsUpdateConnectionData, ThrowOnError>) => RequestResult<ConnectionsUpdateConnectionResponses, ConnectionsUpdateConnectionErrors, ThrowOnError>;
 /**
- * List the caller's default connections, one per application where a default is set.
+ * List default connections.
+ *
+ * Returns the caller's default connections, one per application where a default is set.
+ * Defaults drive implicit connection resolution everywhere a connection isn't explicitly
+ * specified - e.g. POST /tools/{toolSlug}/execute without a connectionId or
+ * toolsetId.
  */
 declare const connectionsGetDefaultConnections: <ThrowOnError extends boolean = false>(options?: Options<ConnectionsGetDefaultConnectionsData, ThrowOnError>) => RequestResult<ConnectionsGetDefaultConnectionsResponses, ConnectionsGetDefaultConnectionsErrors, ThrowOnError>;
 /**
- * Clear the default designation for the given connection.
+ * Clear a default connection.
+ *
+ * Clears the default designation for the given connection. After this, implicit
+ * connection resolution for that application falls back to the single-connection rule
+ * (used automatically when exactly one connection exists) or otherwise requires an
+ * explicit connectionId/toolsetId.
  */
 declare const connectionsClearDefaultConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsClearDefaultConnectionData, ThrowOnError>) => RequestResult<ConnectionsClearDefaultConnectionResponses, ConnectionsClearDefaultConnectionErrors, ThrowOnError>;
 /**
- * Set the given connection as the caller's default for its application.
+ * Set a default connection.
+ *
+ * Marks the given connection as the caller's default for its application, replacing any
+ * previous default for that application. Subsequent calls that omit an explicit
+ * connectionId/toolsetId resolve to this connection.
  */
 declare const connectionsSetDefaultConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsSetDefaultConnectionData, ThrowOnError>) => RequestResult<ConnectionsSetDefaultConnectionResponses, ConnectionsSetDefaultConnectionErrors, ThrowOnError>;
 /**
- * Replace one connection with another across the caller's usages.
+ * Replace a connection.
+ *
+ * Repoints a specific workflow's usage from originalConnectionId to
+ * newConnectionId. Both connections must belong to the caller's account; the
+ * original connection itself is left intact and is not deleted by this call.
  */
 declare const connectionsReplaceConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsReplaceConnectionData, ThrowOnError>) => RequestResult<ConnectionsReplaceConnectionResponses, ConnectionsReplaceConnectionErrors, ThrowOnError>;
 /**
- * Trigger a refresh of the objects available through the given connection.
+ * Refresh connection objects.
+ *
+ * Triggers an asynchronous refresh of the objects (e.g. tables, lists) the given
+ * connection exposes. This returns immediately once the refresh is initiated; poll
+ * GET /connections/{connectionId}/refresh-status to observe completion. A new
+ * refresh cannot be started within 15 minutes of the previous one.
  */
 declare const connectionsRefreshObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsRefreshObjectsData, ThrowOnError>) => RequestResult<ConnectionsRefreshObjectsResponses, ConnectionsRefreshObjectsErrors, ThrowOnError>;
 /**
- * Get the status of the most recent object refresh for the given connection.
+ * Get the refresh status.
+ *
+ * Returns the status of the most recent object refresh triggered by
+ * POST /connections/{connectionId}/refresh-objects for the given connection,
+ * including whether it is still running, when it last completed, and any error.
  */
 declare const connectionsGetRefreshStatus: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetRefreshStatusData, ThrowOnError>) => RequestResult<ConnectionsGetRefreshStatusResponses, ConnectionsGetRefreshStatusErrors, ThrowOnError>;
 /**
- * Select which objects from the given connection are active for the caller.
+ * Select connection objects.
+ *
+ * Saves which objects (e.g. tables, lists) discovered on the given connection are active
+ * - used where an application exposes more objects than are relevant, so the caller can
+ * scope the connection down to the ones it needs. Replaces the entire selection; it does
+ * not merge with the previous one.
  */
 declare const connectionsSelectObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsSelectObjectsData, ThrowOnError>) => RequestResult<ConnectionsSelectObjectsResponses, ConnectionsSelectObjectsErrors, ThrowOnError>;
 /**
- * List the objects available through the given connection, with optional filtering, sorting, and pagination.
+ * List connection objects.
+ *
+ * Returns the objects (e.g. tables, lists) discovered on the given connection, honoring
+ * the optional name filter, sort expression, and pagination. top is silently
+ * clamped to the range 1-1000 (default 100) and a negative offset is treated as 0.
+ * Run POST /connections/{connectionId}/refresh-objects first if the connection's
+ * objects have changed upstream.
  */
 declare const connectionsGetConnectionObjects: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetConnectionObjectsData, ThrowOnError>) => RequestResult<ConnectionsGetConnectionObjectsResponses, ConnectionsGetConnectionObjectsErrors, ThrowOnError>;
 /**
- * Verify that the given connection is valid and currently usable.
+ * Check a connection.
+ *
+ * Verifies that the given connection is valid and currently usable - e.g. its stored
+ * credentials still authenticate against the target application. Returns a non-2xx error
+ * if the connection is no longer healthy.
  */
 declare const connectionsCheckConnection: <ThrowOnError extends boolean = false>(options: Options<ConnectionsCheckConnectionData, ThrowOnError>) => RequestResult<ConnectionsCheckConnectionResponses, ConnectionsCheckConnectionErrors, ThrowOnError>;
 /**
- * Build an OAuth sign-in URL for an application so the caller can authorize a new connection.
+ * Get an OAuth sign-in URL.
+ *
+ * First half of the OAuth pairing with GET /connections/access-token/{state}.
+ * Builds a sign-in URL for the given application and authentication method, along with a
+ * freshly generated opaque state value. Redirect the end user to signInUrl to
+ * authorize; once they complete the provider's consent screen, poll the access-token
+ * endpoint with the same state to retrieve the resulting token data.
  */
 declare const connectionsGetSignInUrl: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetSignInUrlData, ThrowOnError>) => RequestResult<ConnectionsGetSignInUrlResponses, ConnectionsGetSignInUrlErrors, ThrowOnError>;
 /**
- * Retrieve the access token captured for a previously issued sign-in URL, identified by its state value.
+ * Get the access token for a sign-in.
+ *
+ * Second half of the OAuth pairing with POST /connections/get-sign-in-url. Retrieves
+ * the token data captured once the end user completes the sign-in flow for the given
+ * state. Returns a null body if the flow hasn't completed yet - poll until a
+ * non-null response is returned, then use tokenData/connectionData to
+ * complete the connection.
  */
 declare const connectionsGetAccessToken: <ThrowOnError extends boolean = false>(options: Options<ConnectionsGetAccessTokenData, ThrowOnError>) => RequestResult<ConnectionsGetAccessTokenResponses, ConnectionsGetAccessTokenErrors, ThrowOnError>;
 /**
- * List the tools available to the caller, with optional filtering and pagination.
+ * List tools.
+ *
+ * Returns the tools available to the caller across all applications, honoring the optional
+ * filters and pagination. Set available=true to restrict results to tools the caller
+ * can currently execute. Supplying toolsetId additionally includes the caller's
+ * workflow-backed tools scoped to that toolset, alongside the standard activity tools.
+ * Deprecated tools are excluded unless includeDeprecated=true.
  */
 declare const toolsListTools: <ThrowOnError extends boolean = false>(options?: Options<ToolsListToolsData, ThrowOnError>) => RequestResult<ToolsListToolsResponses, ToolsListToolsErrors, ThrowOnError>;
 /**
- * Get the full details of a single tool identified by its slug.
+ * Get a tool.
+ *
+ * Fetches the full detail for a single tool, identified by its slug, including its
+ * input/output JSON schemas and execution capability flags (filters, sort, pagination).
+ * Supply applicationSlug to disambiguate when the same tool slug exists under more
+ * than one application. Supplying toolsetId additionally allows a workflow-backed tool
+ * within that toolset to resolve by slug.
  */
 declare const toolsGetTool: <ThrowOnError extends boolean = false>(options: Options<ToolsGetToolData, ThrowOnError>) => RequestResult<ToolsGetToolResponses, ToolsGetToolErrors, ThrowOnError>;
 /**
- * Execute a tool. Connection is resolved implicitly from the caller's
- * account-user, the tool's parent application, and optional toolsetId.
- * Tool-runtime failures return 200 with isSuccess=false; all other failures
- * use the standard error envelope.
+ * Execute a tool.
+ *
+ * Executes the named tool with the given input fields. The connection to use is resolved
+ * implicitly: an explicit connectionId takes precedence, then toolsetId scopes
+ * resolution to that toolset's connection for the tool's application, and otherwise the
+ * caller's default connection for the application is used. Tool-runtime failures - the
+ * downstream call itself failing - are reported as a 200 response with
+ * isSuccess=false and an errorMessage, not as a 4xx/5xx, so callers must check
+ * isSuccess even on a successful HTTP response. A 409 is returned only when no
+ * connection can be resolved at all (no toolset connection for the app, or no default
+ * connection configured); every other failure uses the standard error envelope.
  */
 declare const toolsExecuteTool: <ThrowOnError extends boolean = false>(options: Options<ToolsExecuteToolData, ThrowOnError>) => RequestResult<ToolsExecuteToolResponses, ToolsExecuteToolErrors, ThrowOnError>;
 /**
- * List the toolsets belonging to the caller, with pagination.
+ * List toolsets.
+ *
+ * Returns the toolsets owned by the caller, paginated. top is silently clamped to
+ * the range 1-100 and a negative offset is treated as 0.
  */
 declare const toolsetsListToolsets: <ThrowOnError extends boolean = false>(options?: Options<ToolsetsListToolsetsData, ThrowOnError>) => RequestResult<ToolsetsListToolsetsResponses, ToolsetsListToolsetsErrors, ThrowOnError>;
 /**
- * Create a new toolset for the caller.
+ * Create a toolset.
+ *
+ * Creates a new toolset owned by the caller, with the given connections (and their
+ * permitted tool slugs) and workflows. A connection entry may omit connectionId and
+ * instead supply applicationSlug or at least one tool slug, letting the caller's
+ * default connection for that application be resolved and stored at save time.
  */
 declare const toolsetsCreateToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsCreateToolsetData, ThrowOnError>) => RequestResult<ToolsetsCreateToolsetResponses, ToolsetsCreateToolsetErrors, ThrowOnError>;
 /**
- * Delete a toolset owned by the caller.
+ * Delete a toolset.
+ *
+ * Permanently deletes a toolset owned by the caller, including its connection and
+ * workflow associations. This does not delete the underlying connections or workflows
+ * themselves. Returns an error if the toolset does not exist.
  */
 declare const toolsetsDeleteToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsDeleteToolsetData, ThrowOnError>) => RequestResult<ToolsetsDeleteToolsetResponses, ToolsetsDeleteToolsetErrors, ThrowOnError>;
 /**
- * Get a single toolset owned by the caller, identified by its id.
+ * Get a toolset.
+ *
+ * Fetches a single toolset by id, including its member connections (with their permitted
+ * tools) and any included workflows. Returns an error if the toolset does not exist or is
+ * not owned by the caller.
  */
 declare const toolsetsGetToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsGetToolsetData, ThrowOnError>) => RequestResult<ToolsetsGetToolsetResponses, ToolsetsGetToolsetErrors, ThrowOnError>;
 /**
- * Update an existing toolset owned by the caller.
+ * Update a toolset.
+ *
+ * Updates a toolset owned by the caller. Only the fields present in the request body are
+ * changed - name, connections, and workflows are each left unchanged
+ * when omitted (null); supplying connections or workflows replaces the
+ * entire set, it does not merge with the existing one.
  */
 declare const toolsetsUpdateToolset: <ThrowOnError extends boolean = false>(options: Options<ToolsetsUpdateToolsetData, ThrowOnError>) => RequestResult<ToolsetsUpdateToolsetResponses, ToolsetsUpdateToolsetErrors, ThrowOnError>;