@operla-ai/sdk 0.6.0 → 1.0.0

package/dist/generated/types.gen.d.ts

@@ -2,6 +2,1090 @@ export type ClientOptions = {
     baseUrl: 'https://{subdomain}.operla.ai' | (string & {});
 };
 export type ListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/actions';
+};
+export type ListErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type ListError = ListErrors[keyof ListErrors];
+export type ListResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Action configurations visible to the caller.
+         */
+        actions: Array<{
+            /**
+             * Stable slug the AI emits and the identifier this action is addressed by. Immutable after creation. Write it in English — it is read by the AI.
+             */
+            type: string;
+            /**
+             * Human-readable name shown in the dashboard. Best kept in English, to match the type.
+             */
+            label: string;
+            /**
+             * Tells the AI when to use this action.
+             */
+            description: string;
+            /**
+             * disabled: never proposed. copilot: proposed, needs a human. autopilot: executed.
+             */
+            mode: 'disabled' | 'copilot' | 'autopilot';
+            /**
+             * Specialist agents allowed to propose this action.
+             */
+            allowedAgents: Array<string>;
+            /**
+             * What the AI extracts from the conversation.
+             */
+            paramsSchema: Array<{
+                /**
+                 * Param name as it appears in the webhook payload.
+                 */
+                name: string;
+                /**
+                 * Value type the AI must extract.
+                 */
+                type: 'string' | 'number' | 'boolean';
+                /**
+                 * Whether the AI must always provide it.
+                 */
+                required?: boolean;
+                /**
+                 * Fed verbatim to the AI — this is what drives extraction quality.
+                 */
+                description: string;
+                /**
+                 * String params only. Restricts the AI to these values.
+                 */
+                enum?: Array<string>;
+            }>;
+            /**
+             * Your endpoint, called with the `execute` event.
+             */
+            webhookUrl: string;
+            /**
+             * Your endpoint for the `eligibility_check` event — your own deterministic ruling on whether the AI may use this action. Omit to leave that call to the AI.
+             */
+            eligibilityUrl?: string;
+            /**
+             * Where the configuration applies. `global` covers the whole tenant; an organization- or entity-level config overrides it for that perimeter.
+             */
+            scope: {
+                /**
+                 * Cascade level this config applies at.
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * Set when level is organization or entity.
+                 */
+                organizationId?: string | null;
+                /**
+                 * Set when level is entity.
+                 */
+                entityId?: string | null;
+            };
+            /**
+             * ISO timestamp when the config was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+        }>;
+    };
+};
+export type ListResponse = ListResponses[keyof ListResponses];
+export type CreateData = {
+    body?: {
+        /**
+         * Human-readable label. The action's machine type is derived from it (lower-cased, words joined by `_`). Write it in English — the derived type is what the AI reads.
+         */
+        label: string;
+        /**
+         * Description the specialist agent uses to decide when to trigger the action.
+         */
+        description: string;
+        /**
+         * Processing mode (`disabled` / `copilot` / `autopilot`). Defaults to `copilot`.
+         */
+        mode?: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Specialist agents allowed to propose this action, by machine name (e.g. `specialist_refund`).
+         */
+        allowedAgents: Array<string>;
+        /**
+         * What the AI must extract from the conversation and send back in the webhook `params`. Defaults to an empty list.
+         */
+        paramsSchema?: Array<{
+            /**
+             * Param name as it appears in the webhook payload.
+             */
+            name: string;
+            /**
+             * Value type the AI must extract.
+             */
+            type: 'string' | 'number' | 'boolean';
+            /**
+             * Whether the AI must always provide it.
+             */
+            required?: boolean;
+            /**
+             * Fed verbatim to the AI — this is what drives extraction quality.
+             */
+            description: string;
+            /**
+             * String params only. Restricts the AI to these values.
+             */
+            enum?: Array<string>;
+        }>;
+        /**
+         * HTTPS endpoint we POST the `execute` event to. Private and link-local addresses are refused, at save time and again at call time.
+         */
+        webhookUrl: string;
+        /**
+         * HTTPS endpoint we POST the `eligibility_check` event to, before the AI decides anything — so a refused action is never proposed nor promised. Omit it and the action is available on the AI's judgement alone, with no deterministic gate.
+         */
+        eligibilityUrl?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/actions';
+};
+export type CreateErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * 409 error
+     */
+    409: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'CONFIG-EXISTS';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type CreateError = CreateErrors[keyof CreateErrors];
+export type CreateResponses = {
+    /**
+     * Action created.
+     */
+    201: {
+        /**
+         * The action configuration.
+         */
+        action: {
+            /**
+             * Stable slug the AI emits and the identifier this action is addressed by. Immutable after creation. Write it in English — it is read by the AI.
+             */
+            type: string;
+            /**
+             * Human-readable name shown in the dashboard. Best kept in English, to match the type.
+             */
+            label: string;
+            /**
+             * Tells the AI when to use this action.
+             */
+            description: string;
+            /**
+             * disabled: never proposed. copilot: proposed, needs a human. autopilot: executed.
+             */
+            mode: 'disabled' | 'copilot' | 'autopilot';
+            /**
+             * Specialist agents allowed to propose this action.
+             */
+            allowedAgents: Array<string>;
+            /**
+             * What the AI extracts from the conversation.
+             */
+            paramsSchema: Array<{
+                /**
+                 * Param name as it appears in the webhook payload.
+                 */
+                name: string;
+                /**
+                 * Value type the AI must extract.
+                 */
+                type: 'string' | 'number' | 'boolean';
+                /**
+                 * Whether the AI must always provide it.
+                 */
+                required?: boolean;
+                /**
+                 * Fed verbatim to the AI — this is what drives extraction quality.
+                 */
+                description: string;
+                /**
+                 * String params only. Restricts the AI to these values.
+                 */
+                enum?: Array<string>;
+            }>;
+            /**
+             * Your endpoint, called with the `execute` event.
+             */
+            webhookUrl: string;
+            /**
+             * Your endpoint for the `eligibility_check` event — your own deterministic ruling on whether the AI may use this action. Omit to leave that call to the AI.
+             */
+            eligibilityUrl?: string;
+            /**
+             * Where the configuration applies. `global` covers the whole tenant; an organization- or entity-level config overrides it for that perimeter.
+             */
+            scope: {
+                /**
+                 * Cascade level this config applies at.
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * Set when level is organization or entity.
+                 */
+                organizationId?: string | null;
+                /**
+                 * Set when level is entity.
+                 */
+                entityId?: string | null;
+            };
+            /**
+             * ISO timestamp when the config was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+        };
+    };
+};
+export type CreateResponse = CreateResponses[keyof CreateResponses];
+export type DeleteData = {
+    body?: never;
+    path: {
+        /**
+         * Machine name of the action (e.g. `create_booking`) — what it is addressed by.
+         */
+        type: string;
+    };
+    query?: never;
+    url: '/actions/{type}';
+};
+export type DeleteErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Resource not found
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type DeleteError = DeleteErrors[keyof DeleteErrors];
+export type DeleteResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Confirmation message describing the outcome.
+         */
+        message: string;
+    };
+};
+export type DeleteResponse = DeleteResponses[keyof DeleteResponses];
+export type GetData = {
+    body?: never;
+    path: {
+        /**
+         * Machine name of the action (e.g. `create_booking`) — what it is addressed by.
+         */
+        type: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/actions/{type}';
+};
+export type GetErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Resource not found
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type GetError = GetErrors[keyof GetErrors];
+export type GetResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * The action configuration.
+         */
+        action: {
+            /**
+             * Stable slug the AI emits and the identifier this action is addressed by. Immutable after creation. Write it in English — it is read by the AI.
+             */
+            type: string;
+            /**
+             * Human-readable name shown in the dashboard. Best kept in English, to match the type.
+             */
+            label: string;
+            /**
+             * Tells the AI when to use this action.
+             */
+            description: string;
+            /**
+             * disabled: never proposed. copilot: proposed, needs a human. autopilot: executed.
+             */
+            mode: 'disabled' | 'copilot' | 'autopilot';
+            /**
+             * Specialist agents allowed to propose this action.
+             */
+            allowedAgents: Array<string>;
+            /**
+             * What the AI extracts from the conversation.
+             */
+            paramsSchema: Array<{
+                /**
+                 * Param name as it appears in the webhook payload.
+                 */
+                name: string;
+                /**
+                 * Value type the AI must extract.
+                 */
+                type: 'string' | 'number' | 'boolean';
+                /**
+                 * Whether the AI must always provide it.
+                 */
+                required?: boolean;
+                /**
+                 * Fed verbatim to the AI — this is what drives extraction quality.
+                 */
+                description: string;
+                /**
+                 * String params only. Restricts the AI to these values.
+                 */
+                enum?: Array<string>;
+            }>;
+            /**
+             * Your endpoint, called with the `execute` event.
+             */
+            webhookUrl: string;
+            /**
+             * Your endpoint for the `eligibility_check` event — your own deterministic ruling on whether the AI may use this action. Omit to leave that call to the AI.
+             */
+            eligibilityUrl?: string;
+            /**
+             * Where the configuration applies. `global` covers the whole tenant; an organization- or entity-level config overrides it for that perimeter.
+             */
+            scope: {
+                /**
+                 * Cascade level this config applies at.
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * Set when level is organization or entity.
+                 */
+                organizationId?: string | null;
+                /**
+                 * Set when level is entity.
+                 */
+                entityId?: string | null;
+            };
+            /**
+             * ISO timestamp when the config was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+        };
+    };
+};
+export type GetResponse = GetResponses[keyof GetResponses];
+export type UpdateData = {
+    body?: {
+        /**
+         * Description the specialist agent uses to decide when to trigger the action.
+         */
+        description?: string;
+        /**
+         * Processing mode (`disabled` / `copilot` / `autopilot`).
+         */
+        mode?: 'disabled' | 'copilot' | 'autopilot';
+        /**
+         * Specialist agents allowed to propose this action, by machine name.
+         */
+        allowedAgents?: Array<string>;
+        /**
+         * Replaces the whole list — send every param you want to keep.
+         */
+        paramsSchema?: Array<{
+            /**
+             * Param name as it appears in the webhook payload.
+             */
+            name: string;
+            /**
+             * Value type the AI must extract.
+             */
+            type: 'string' | 'number' | 'boolean';
+            /**
+             * Whether the AI must always provide it.
+             */
+            required?: boolean;
+            /**
+             * Fed verbatim to the AI — this is what drives extraction quality.
+             */
+            description: string;
+            /**
+             * String params only. Restricts the AI to these values.
+             */
+            enum?: Array<string>;
+        }>;
+        /**
+         * HTTPS endpoint we POST the `execute` event to.
+         */
+        webhookUrl?: string;
+        /**
+         * HTTPS endpoint we POST the `eligibility_check` event to, before the AI decides anything. Send `null` to remove it — the action is then available on the AI's judgement alone, with no deterministic gate.
+         */
+        eligibilityUrl?: string | null;
+    };
+    path: {
+        /**
+         * Machine name of the action (e.g. `create_booking`) — what it is addressed by.
+         */
+        type: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/actions/{type}';
+};
+export type UpdateErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Resource not found
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type UpdateError = UpdateErrors[keyof UpdateErrors];
+export type UpdateResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * The action configuration.
+         */
+        action: {
+            /**
+             * Stable slug the AI emits and the identifier this action is addressed by. Immutable after creation. Write it in English — it is read by the AI.
+             */
+            type: string;
+            /**
+             * Human-readable name shown in the dashboard. Best kept in English, to match the type.
+             */
+            label: string;
+            /**
+             * Tells the AI when to use this action.
+             */
+            description: string;
+            /**
+             * disabled: never proposed. copilot: proposed, needs a human. autopilot: executed.
+             */
+            mode: 'disabled' | 'copilot' | 'autopilot';
+            /**
+             * Specialist agents allowed to propose this action.
+             */
+            allowedAgents: Array<string>;
+            /**
+             * What the AI extracts from the conversation.
+             */
+            paramsSchema: Array<{
+                /**
+                 * Param name as it appears in the webhook payload.
+                 */
+                name: string;
+                /**
+                 * Value type the AI must extract.
+                 */
+                type: 'string' | 'number' | 'boolean';
+                /**
+                 * Whether the AI must always provide it.
+                 */
+                required?: boolean;
+                /**
+                 * Fed verbatim to the AI — this is what drives extraction quality.
+                 */
+                description: string;
+                /**
+                 * String params only. Restricts the AI to these values.
+                 */
+                enum?: Array<string>;
+            }>;
+            /**
+             * Your endpoint, called with the `execute` event.
+             */
+            webhookUrl: string;
+            /**
+             * Your endpoint for the `eligibility_check` event — your own deterministic ruling on whether the AI may use this action. Omit to leave that call to the AI.
+             */
+            eligibilityUrl?: string;
+            /**
+             * Where the configuration applies. `global` covers the whole tenant; an organization- or entity-level config overrides it for that perimeter.
+             */
+            scope: {
+                /**
+                 * Cascade level this config applies at.
+                 */
+                level: 'global' | 'organization' | 'entity';
+                /**
+                 * Set when level is organization or entity.
+                 */
+                organizationId?: string | null;
+                /**
+                 * Set when level is entity.
+                 */
+                entityId?: string | null;
+            };
+            /**
+             * ISO timestamp when the config was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+        };
+    };
+};
+export type UpdateResponse = UpdateResponses[keyof UpdateResponses];
+export type DeleteOverrideData = {
+    body?: never;
+    path: {
+        /**
+         * Machine name of the action (e.g. `create_booking`) — what it is addressed by.
+         */
+        type: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/actions/{type}/override';
+};
+export type DeleteOverrideErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+    /**
+     * Resource not found
+     */
+    404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
+        statusCode: number;
+        /**
+         * Error details.
+         */
+        error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
+            code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
+            message: string;
+        };
+    };
+};
+export type DeleteOverrideError = DeleteOverrideErrors[keyof DeleteOverrideErrors];
+export type DeleteOverrideResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Confirmation message describing the outcome.
+         */
+        message: string;
+    };
+};
+export type DeleteOverrideResponse = DeleteOverrideResponses[keyof DeleteOverrideResponses];
+export type List2Data = {
     body?: never;
     path?: never;
     query?: {
@@ -12,14 +1096,26 @@ export type ListData = {
     };
     url: '/agents';
 };
-export type ListErrors = {
+export type List2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -27,9 +1123,21 @@ export type ListErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -37,15 +1145,27 @@ export type ListErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type ListError = ListErrors[keyof ListErrors];
-export type ListResponses = {
+export type List2Error = List2Errors[keyof List2Errors];
+export type List2Responses = {
     /**
      * Successful response
      */
@@ -90,8 +1210,8 @@ export type ListResponses = {
         }>;
     };
 };
-export type ListResponse = ListResponses[keyof ListResponses];
-export type CreateData = {
+export type List2Response = List2Responses[keyof List2Responses];
+export type Create2Data = {
     body?: {
         /**
          * Human-readable label shown in the dashboard. The machine name is derived from this (slugified, prefixed with `specialist_`).
@@ -164,14 +1284,26 @@ export type CreateData = {
     query?: never;
     url: '/agents';
 };
-export type CreateErrors = {
+export type Create2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -179,9 +1311,21 @@ export type CreateErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -189,15 +1333,27 @@ export type CreateErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type CreateError = CreateErrors[keyof CreateErrors];
-export type CreateResponses = {
+export type Create2Error = Create2Errors[keyof Create2Errors];
+export type Create2Responses = {
     /**
      * Successful response
      */
@@ -533,8 +1689,8 @@ export type CreateResponses = {
         };
     };
 };
-export type CreateResponse = CreateResponses[keyof CreateResponses];
-export type DeleteData = {
+export type Create2Response = Create2Responses[keyof Create2Responses];
+export type Delete2Data = {
     body?: never;
     path: {
         /**
@@ -545,14 +1701,26 @@ export type DeleteData = {
     query?: never;
     url: '/agents/{name}';
 };
-export type DeleteErrors = {
+export type Delete2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -560,9 +1728,21 @@ export type DeleteErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -570,15 +1750,27 @@ export type DeleteErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type DeleteError = DeleteErrors[keyof DeleteErrors];
-export type DeleteResponses = {
+export type Delete2Error = Delete2Errors[keyof Delete2Errors];
+export type Delete2Responses = {
     /**
      * Successful response
      */
@@ -589,8 +1781,8 @@ export type DeleteResponses = {
         message: string;
     };
 };
-export type DeleteResponse = DeleteResponses[keyof DeleteResponses];
-export type GetData = {
+export type Delete2Response = Delete2Responses[keyof Delete2Responses];
+export type Get2Data = {
     body?: never;
     path: {
         /**
@@ -606,14 +1798,26 @@ export type GetData = {
     };
     url: '/agents/{name}';
 };
-export type GetErrors = {
+export type Get2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -621,9 +1825,21 @@ export type GetErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -631,15 +1847,27 @@ export type GetErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type GetError = GetErrors[keyof GetErrors];
-export type GetResponses = {
+export type Get2Error = Get2Errors[keyof Get2Errors];
+export type Get2Responses = {
     /**
      * Successful response
      */
@@ -975,8 +2203,8 @@ export type GetResponses = {
         };
     };
 };
-export type GetResponse = GetResponses[keyof GetResponses];
-export type UpdateData = {
+export type Get2Response = Get2Responses[keyof Get2Responses];
+export type Update2Data = {
     body?: {
         /**
          * System prompt for the agent. Editable on specialist agents only.
@@ -1128,14 +2356,26 @@ export type UpdateData = {
     };
     url: '/agents/{name}';
 };
-export type UpdateErrors = {
+export type Update2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1143,9 +2383,21 @@ export type UpdateErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1153,15 +2405,27 @@ export type UpdateErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type UpdateError = UpdateErrors[keyof UpdateErrors];
-export type UpdateResponses = {
+export type Update2Error = Update2Errors[keyof Update2Errors];
+export type Update2Responses = {
     /**
      * Successful response
      */
@@ -1497,8 +2761,8 @@ export type UpdateResponses = {
         };
     };
 };
-export type UpdateResponse = UpdateResponses[keyof UpdateResponses];
-export type DeleteOverrideData = {
+export type Update2Response = Update2Responses[keyof Update2Responses];
+export type DeleteOverride2Data = {
     body?: never;
     path: {
         /**
@@ -1514,14 +2778,26 @@ export type DeleteOverrideData = {
     };
     url: '/agents/{name}/overrides';
 };
-export type DeleteOverrideErrors = {
+export type DeleteOverride2Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1529,9 +2805,21 @@ export type DeleteOverrideErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1539,15 +2827,27 @@ export type DeleteOverrideErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type DeleteOverrideError = DeleteOverrideErrors[keyof DeleteOverrideErrors];
-export type DeleteOverrideResponses = {
+export type DeleteOverride2Error = DeleteOverride2Errors[keyof DeleteOverride2Errors];
+export type DeleteOverride2Responses = {
     /**
      * Successful response
      */
@@ -1558,7 +2858,7 @@ export type DeleteOverrideResponses = {
         message: string;
     };
 };
-export type DeleteOverrideResponse = DeleteOverrideResponses[keyof DeleteOverrideResponses];
+export type DeleteOverride2Response = DeleteOverride2Responses[keyof DeleteOverride2Responses];
 export type PublishData = {
     body?: {
         /**
@@ -1585,9 +2885,21 @@ export type PublishErrors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1595,9 +2907,21 @@ export type PublishErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1605,9 +2929,21 @@ export type PublishErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1976,9 +3312,21 @@ export type RollbackErrors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1986,9 +3334,21 @@ export type RollbackErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -1996,9 +3356,21 @@ export type RollbackErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2341,7 +3713,7 @@ export type RollbackResponses = {
     };
 };
 export type RollbackResponse = RollbackResponses[keyof RollbackResponses];
-export type List2Data = {
+export type List3Data = {
     body?: never;
     path?: never;
     query?: {
@@ -2364,14 +3736,26 @@ export type List2Data = {
     };
     url: '/conversations';
 };
-export type List2Errors = {
+export type List3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2379,9 +3763,21 @@ export type List2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2389,19 +3785,34 @@ export type List2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type List2Error = List2Errors[keyof List2Errors];
-export type List2Responses = {
+export type List3Error = List3Errors[keyof List3Errors];
+export type List3Responses = {
     /**
      * Successful response
      */
     200: {
+        /**
+         * This page of conversations — at most `limit` items, starting at `offset`.
+         */
         conversations: Array<{
             /**
              * Conversation ID (format: conv_xxxxxxxxxxxx).
@@ -2411,7 +3822,13 @@ export type List2Responses = {
              * Organization the conversation is linked to (id + name); null when not tied to one.
              */
             organization: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
                 id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
                 name: string;
             } | null;
             /**
@@ -2439,7 +3856,13 @@ export type List2Responses = {
              * Entity the conversation is linked to (id + name); null when not tied to one.
              */
             entity: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
                 id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
                 name: string;
             } | null;
             /**
@@ -2473,8 +3896,8 @@ export type List2Responses = {
         offset: number;
     };
 };
-export type List2Response = List2Responses[keyof List2Responses];
-export type Create2Data = {
+export type List3Response = List3Responses[keyof List3Responses];
+export type Create3Data = {
     body?: {
         /**
          * The person the conversation is with. Set `resolved: true` when you already have a complete profile to skip identity resolution on later messages.
@@ -2508,14 +3931,26 @@ export type Create2Data = {
     query?: never;
     url: '/conversations';
 };
-export type Create2Errors = {
+export type Create3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2523,9 +3958,21 @@ export type Create2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2533,15 +3980,27 @@ export type Create2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Create2Error = Create2Errors[keyof Create2Errors];
-export type Create2Responses = {
+export type Create3Error = Create3Errors[keyof Create3Errors];
+export type Create3Responses = {
     /**
      * Successful response
      */
@@ -2554,7 +4013,13 @@ export type Create2Responses = {
          * Organization the conversation is linked to (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -2588,7 +4053,13 @@ export type Create2Responses = {
          * Entity the conversation is linked to (id + name); null when not tied to one.
          */
         entity: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -2638,8 +4109,8 @@ export type Create2Responses = {
         externalTicketId?: string;
     };
 };
-export type Create2Response = Create2Responses[keyof Create2Responses];
-export type Delete2Data = {
+export type Create3Response = Create3Responses[keyof Create3Responses];
+export type Delete3Data = {
     body?: never;
     path: {
         /**
@@ -2650,14 +4121,26 @@ export type Delete2Data = {
     query?: never;
     url: '/conversations/{conversationId}';
 };
-export type Delete2Errors = {
+export type Delete3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2665,9 +4148,21 @@ export type Delete2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2675,9 +4170,21 @@ export type Delete2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2685,15 +4192,27 @@ export type Delete2Errors = {
      * Conversation does not exist.
      */
     404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Delete2Error = Delete2Errors[keyof Delete2Errors];
-export type Delete2Responses = {
+export type Delete3Error = Delete3Errors[keyof Delete3Errors];
+export type Delete3Responses = {
     /**
      * Successful response
      */
@@ -2704,8 +4223,8 @@ export type Delete2Responses = {
         message: string;
     };
 };
-export type Delete2Response = Delete2Responses[keyof Delete2Responses];
-export type Get2Data = {
+export type Delete3Response = Delete3Responses[keyof Delete3Responses];
+export type Get3Data = {
     body?: never;
     path: {
         /**
@@ -2716,14 +4235,26 @@ export type Get2Data = {
     query?: never;
     url: '/conversations/{conversationId}';
 };
-export type Get2Errors = {
+export type Get3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2731,9 +4262,21 @@ export type Get2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2741,15 +4284,27 @@ export type Get2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Get2Error = Get2Errors[keyof Get2Errors];
-export type Get2Responses = {
+export type Get3Error = Get3Errors[keyof Get3Errors];
+export type Get3Responses = {
     /**
      * Successful response
      */
@@ -2762,7 +4317,13 @@ export type Get2Responses = {
          * Organization the conversation is linked to (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -2796,7 +4357,13 @@ export type Get2Responses = {
          * Entity the conversation is linked to (id + name); null when not tied to one.
          */
         entity: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -2846,7 +4413,7 @@ export type Get2Responses = {
         externalTicketId?: string;
     };
 };
-export type Get2Response = Get2Responses[keyof Get2Responses];
+export type Get3Response = Get3Responses[keyof Get3Responses];
 export type SendMessageData = {
     body?: {
         /**
@@ -2917,9 +4484,21 @@ export type SendMessageErrors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2927,9 +4506,21 @@ export type SendMessageErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2937,9 +4528,21 @@ export type SendMessageErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -2958,7 +4561,13 @@ export type SendMessageResponses = {
          * Organization the conversation is linked to (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -2988,7 +4597,13 @@ export type SendMessageResponses = {
          * Entity the conversation is linked to (id + name); null when not tied to one.
          */
         entity: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3003,6 +4618,27 @@ export type SendMessageResponses = {
          * True when the conversation was escalated to a human agent (hard-rule trigger, action failure, unidentifiable user, etc.), whether the escalation message was auto-sent or held for validation. When auto-sent, `content` is a notice that the request was forwarded.
          */
         escalated: boolean;
+        /**
+         * What became of every action the AI decided on this turn. Empty when it decided none. A `blocked` entry never reached your endpoint, so this is the only place you see it.
+         */
+        actions: Array<{
+            /**
+             * Action type identifier.
+             */
+            type: string;
+            /**
+             * `success`: your endpoint ran it. `failed`: your endpoint reported a failure. `blocked`: refused at the eligibility check, so it was never sent.
+             */
+            status: 'success' | 'failed' | 'blocked';
+            /**
+             * Failure message your endpoint returned. Only on `failed`.
+             */
+            error?: string;
+            /**
+             * Why the action was refused, as your eligibility endpoint phrased it. Only on `blocked`.
+             */
+            reason?: string;
+        }>;
     };
 };
 export type SendMessageResponse = SendMessageResponses[keyof SendMessageResponses];
@@ -3031,9 +4667,21 @@ export type ValidateResponseErrors = {
      * The response cannot be validated in its current state.
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON' | 'ALREADY_SENT' | 'NO_RESPONSE';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3041,9 +4689,21 @@ export type ValidateResponseErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3051,9 +4711,21 @@ export type ValidateResponseErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3061,9 +4733,21 @@ export type ValidateResponseErrors = {
      * Conversation or message at the given index does not exist.
      */
     404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3119,9 +4803,21 @@ export type RejectResponseErrors = {
      * The response cannot be rejected in its current state.
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON' | 'ALREADY_SENT' | 'ALREADY_DECIDED';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3129,9 +4825,21 @@ export type RejectResponseErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3139,9 +4847,21 @@ export type RejectResponseErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3149,9 +4869,21 @@ export type RejectResponseErrors = {
      * Conversation or message at the given index does not exist.
      */
     404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3198,9 +4930,21 @@ export type AppendMessageErrors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3208,9 +4952,21 @@ export type AppendMessageErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3218,9 +4974,21 @@ export type AppendMessageErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3228,9 +4996,21 @@ export type AppendMessageErrors = {
      * Conversation does not exist.
      */
     404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3290,9 +5070,30 @@ export type SimulateData = {
          */
         subject?: string;
         /**
-         * Action types to force into failure, to exercise escalation paths. Simulation-only.
+         * What each action answers instead of calling your webhook, keyed by action type. Same shape as a real `execute` response: `success: false` fails the action with your `error`, and a failure returns no data. Simulation-only.
          */
-        failActions?: Array<string>;
+        actionResponses?: {
+            [key: string]: {
+                /**
+                 * Required. `true` marks the action as succeeded, and lets you return `data`; `false` fails it with your `error`.
+                 */
+                success: boolean;
+                /**
+                 * Payload the action returns, injected into the agent's context as ground truth. Only on a success.
+                 */
+                data?: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Why the action failed, injected into the agent's context so the reply can account for it. Requires `success: false`.
+                 */
+                error?: string;
+                /**
+                 * Hand the conversation to a human once the reply is written, without telling the user.
+                 */
+                silentEscalation?: boolean;
+            };
+        };
         /**
          * Custom key/value pairs attached to the conversation. Available as variables in your agent prompts.
          */
@@ -3313,9 +5114,21 @@ export type SimulateErrors = {
      * The conversation is a real one, or no organization context was provided (admin keys must send X-Organization-Id).
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON' | 'NOT-SIMULATION' | 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3323,9 +5136,21 @@ export type SimulateErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3333,9 +5158,21 @@ export type SimulateErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3343,9 +5180,21 @@ export type SimulateErrors = {
      * Conversation does not exist.
      */
     404: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'NOT-FOUND';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3364,7 +5213,13 @@ export type SimulateResponses = {
          * Organization the conversation is linked to (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3394,7 +5249,13 @@ export type SimulateResponses = {
          * Entity the conversation is linked to (id + name); null when not tied to one.
          */
         entity: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3409,10 +5270,31 @@ export type SimulateResponses = {
          * True when the conversation was escalated to a human agent (hard-rule trigger, action failure, unidentifiable user, etc.), whether the escalation message was auto-sent or held for validation. When auto-sent, `content` is a notice that the request was forwarded.
          */
         escalated: boolean;
+        /**
+         * What became of every action the AI decided on this turn. Empty when it decided none. A `blocked` entry never reached your endpoint, so this is the only place you see it.
+         */
+        actions: Array<{
+            /**
+             * Action type identifier.
+             */
+            type: string;
+            /**
+             * `success`: your endpoint ran it. `failed`: your endpoint reported a failure. `blocked`: refused at the eligibility check, so it was never sent.
+             */
+            status: 'success' | 'failed' | 'blocked';
+            /**
+             * Failure message your endpoint returned. Only on `failed`.
+             */
+            error?: string;
+            /**
+             * Why the action was refused, as your eligibility endpoint phrased it. Only on `blocked`.
+             */
+            reason?: string;
+        }>;
     };
 };
 export type SimulateResponse = SimulateResponses[keyof SimulateResponses];
-export type List3Data = {
+export type List4Data = {
     body?: never;
     path?: never;
     query?: {
@@ -3431,14 +5313,26 @@ export type List3Data = {
     };
     url: '/entities';
 };
-export type List3Errors = {
+export type List4Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3446,9 +5340,21 @@ export type List3Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3456,19 +5362,34 @@ export type List3Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type List3Error = List3Errors[keyof List3Errors];
-export type List3Responses = {
+export type List4Error = List4Errors[keyof List4Errors];
+export type List4Responses = {
     /**
      * Successful response
      */
     200: {
+        /**
+         * This page of entities — at most `limit` items, starting at `offset`.
+         */
         entities: Array<{
             /**
              * Entity ID (format: ent_xxxxxxxxxxxx).
@@ -3478,7 +5399,13 @@ export type List3Responses = {
              * Parent organization ref (id + name); null when not tied to one.
              */
             organization: {
+                /**
+                 * Opaque id of the referenced doc.
+                 */
                 id: string;
+                /**
+                 * Display name of the referenced doc, denormalized so no extra fetch is needed.
+                 */
                 name: string;
             } | null;
             /**
@@ -3508,8 +5435,8 @@ export type List3Responses = {
         offset: number;
     };
 };
-export type List3Response = List3Responses[keyof List3Responses];
-export type Create3Data = {
+export type List4Response = List4Responses[keyof List4Responses];
+export type Create4Data = {
     body?: {
         /**
          * Human-readable name of the entity.
@@ -3526,14 +5453,26 @@ export type Create3Data = {
     query?: never;
     url: '/entities';
 };
-export type Create3Errors = {
+export type Create4Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3541,9 +5480,21 @@ export type Create3Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3551,15 +5502,27 @@ export type Create3Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Create3Error = Create3Errors[keyof Create3Errors];
-export type Create3Responses = {
+export type Create4Error = Create4Errors[keyof Create4Errors];
+export type Create4Responses = {
     /**
      * Successful response
      */
@@ -3572,7 +5535,13 @@ export type Create3Responses = {
          * Parent organization ref (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3595,8 +5564,8 @@ export type Create3Responses = {
         };
     };
 };
-export type Create3Response = Create3Responses[keyof Create3Responses];
-export type Delete3Data = {
+export type Create4Response = Create4Responses[keyof Create4Responses];
+export type Delete4Data = {
     body?: never;
     path: {
         /**
@@ -3607,14 +5576,26 @@ export type Delete3Data = {
     query?: never;
     url: '/entities/{id}';
 };
-export type Delete3Errors = {
+export type Delete4Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3622,9 +5603,21 @@ export type Delete3Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3632,15 +5625,27 @@ export type Delete3Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Delete3Error = Delete3Errors[keyof Delete3Errors];
-export type Delete3Responses = {
+export type Delete4Error = Delete4Errors[keyof Delete4Errors];
+export type Delete4Responses = {
     /**
      * Successful response
      */
@@ -3651,8 +5656,8 @@ export type Delete3Responses = {
         message: string;
     };
 };
-export type Delete3Response = Delete3Responses[keyof Delete3Responses];
-export type Get3Data = {
+export type Delete4Response = Delete4Responses[keyof Delete4Responses];
+export type Get4Data = {
     body?: never;
     path: {
         /**
@@ -3663,14 +5668,26 @@ export type Get3Data = {
     query?: never;
     url: '/entities/{id}';
 };
-export type Get3Errors = {
+export type Get4Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3678,9 +5695,21 @@ export type Get3Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3688,15 +5717,27 @@ export type Get3Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Get3Error = Get3Errors[keyof Get3Errors];
-export type Get3Responses = {
+export type Get4Error = Get4Errors[keyof Get4Errors];
+export type Get4Responses = {
     /**
      * Successful response
      */
@@ -3709,7 +5750,13 @@ export type Get3Responses = {
          * Parent organization ref (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3732,8 +5779,8 @@ export type Get3Responses = {
         };
     };
 };
-export type Get3Response = Get3Responses[keyof Get3Responses];
-export type Update2Data = {
+export type Get4Response = Get4Responses[keyof Get4Responses];
+export type Update3Data = {
     body?: {
         /**
          * New name for the entity.
@@ -3755,14 +5802,26 @@ export type Update2Data = {
     query?: never;
     url: '/entities/{id}';
 };
-export type Update2Errors = {
+export type Update3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3770,9 +5829,21 @@ export type Update2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3780,15 +5851,27 @@ export type Update2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Update2Error = Update2Errors[keyof Update2Errors];
-export type Update2Responses = {
+export type Update3Error = Update3Errors[keyof Update3Errors];
+export type Update3Responses = {
     /**
      * Successful response
      */
@@ -3801,7 +5884,13 @@ export type Update2Responses = {
          * Parent organization ref (id + name); null when not tied to one.
          */
         organization: {
+            /**
+             * Opaque id of the referenced doc.
+             */
             id: string;
+            /**
+             * Display name of the referenced doc, denormalized so no extra fetch is needed.
+             */
             name: string;
         } | null;
         /**
@@ -3824,8 +5913,8 @@ export type Update2Responses = {
         };
     };
 };
-export type Update2Response = Update2Responses[keyof Update2Responses];
-export type List4Data = {
+export type Update3Response = Update3Responses[keyof Update3Responses];
+export type List5Data = {
     body?: never;
     path?: never;
     query?: {
@@ -3836,14 +5925,26 @@ export type List4Data = {
     };
     url: '/intents';
 };
-export type List4Errors = {
+export type List5Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3851,9 +5952,21 @@ export type List4Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3861,15 +5974,27 @@ export type List4Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type List4Error = List4Errors[keyof List4Errors];
-export type List4Responses = {
+export type List5Error = List5Errors[keyof List5Errors];
+export type List5Responses = {
     /**
      * Successful response
      */
@@ -3879,13 +6004,9 @@ export type List4Responses = {
          */
         intents: Array<{
             /**
-             * Opaque intent id (prefixed `int_`).
-             */
-            id: string;
-            /**
-             * Machine name — stable identifier used across the API.
+             * Machine name — the identifier this intent is addressed by.
              */
-            intent: string;
+            type: string;
             /**
              * Human-readable label.
              */
@@ -3939,11 +6060,11 @@ export type List4Responses = {
         }>;
     };
 };
-export type List4Response = List4Responses[keyof List4Responses];
-export type Create4Data = {
+export type List5Response = List5Responses[keyof List5Responses];
+export type Create5Data = {
     body?: {
         /**
-         * Human-readable label. The intent's machine name is derived from it (lower-cased, words joined by `_`).
+         * Human-readable label. The intent's machine name is derived from it (lower-cased, words joined by `_`). Write it in English — the derived name is what the AI reads.
          */
         label: string;
         /**
@@ -3980,14 +6101,26 @@ export type Create4Data = {
     query?: never;
     url: '/intents';
 };
-export type Create4Errors = {
+export type Create5Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -3995,9 +6128,21 @@ export type Create4Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4005,27 +6150,35 @@ export type Create4Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Create4Error = Create4Errors[keyof Create4Errors];
-export type Create4Responses = {
+export type Create5Error = Create5Errors[keyof Create5Errors];
+export type Create5Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Opaque intent id (prefixed `int_`).
+         * Machine name — the identifier this intent is addressed by.
          */
-        id: string;
-        /**
-         * Machine name — stable identifier used across the API.
-         */
-        intent: string;
+        type: string;
         /**
          * Human-readable label.
          */
@@ -4078,23 +6231,38 @@ export type Create4Responses = {
         };
     };
 };
-export type Create4Response = Create4Responses[keyof Create4Responses];
-export type Delete4Data = {
+export type Create5Response = Create5Responses[keyof Create5Responses];
+export type Delete5Data = {
     body?: never;
     path: {
-        id: string;
+        /**
+         * Machine name of the intent (e.g. `refund_request`) — what it is addressed by.
+         */
+        type: string;
     };
     query?: never;
-    url: '/intents/{id}';
+    url: '/intents/{type}';
 };
-export type Delete4Errors = {
+export type Delete5Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4102,9 +6270,21 @@ export type Delete4Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4112,15 +6292,27 @@ export type Delete4Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Delete4Error = Delete4Errors[keyof Delete4Errors];
-export type Delete4Responses = {
+export type Delete5Error = Delete5Errors[keyof Delete5Errors];
+export type Delete5Responses = {
     /**
      * Successful response
      */
@@ -4131,11 +6323,14 @@ export type Delete4Responses = {
         message: string;
     };
 };
-export type Delete4Response = Delete4Responses[keyof Delete4Responses];
-export type Get4Data = {
+export type Delete5Response = Delete5Responses[keyof Delete5Responses];
+export type Get5Data = {
     body?: never;
     path: {
-        id: string;
+        /**
+         * Machine name of the intent (e.g. `refund_request`) — what it is addressed by.
+         */
+        type: string;
     };
     query?: {
         /**
@@ -4143,16 +6338,28 @@ export type Get4Data = {
          */
         entityId?: string;
     };
-    url: '/intents/{id}';
+    url: '/intents/{type}';
 };
-export type Get4Errors = {
+export type Get5Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4160,9 +6367,21 @@ export type Get4Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4170,27 +6389,35 @@ export type Get4Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Get4Error = Get4Errors[keyof Get4Errors];
-export type Get4Responses = {
+export type Get5Error = Get5Errors[keyof Get5Errors];
+export type Get5Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Opaque intent id (prefixed `int_`).
-         */
-        id: string;
-        /**
-         * Machine name — stable identifier used across the API.
+         * Machine name — the identifier this intent is addressed by.
          */
-        intent: string;
+        type: string;
         /**
          * Human-readable label.
          */
@@ -4243,13 +6470,9 @@ export type Get4Responses = {
         };
     };
 };
-export type Get4Response = Get4Responses[keyof Get4Responses];
-export type Update3Data = {
+export type Get5Response = Get5Responses[keyof Get5Responses];
+export type Update4Data = {
     body?: {
-        /**
-         * Human-readable label.
-         */
-        label?: string;
         /**
          * Description the orchestrator uses to classify user messages.
          */
@@ -4281,7 +6504,10 @@ export type Update3Data = {
         order?: number;
     };
     path: {
-        id: string;
+        /**
+         * Machine name of the intent (e.g. `refund_request`) — what it is addressed by.
+         */
+        type: string;
     };
     query?: {
         /**
@@ -4289,16 +6515,28 @@ export type Update3Data = {
          */
         entityId?: string;
     };
-    url: '/intents/{id}';
+    url: '/intents/{type}';
 };
-export type Update3Errors = {
+export type Update4Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4306,9 +6544,21 @@ export type Update3Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4316,27 +6566,35 @@ export type Update3Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Update3Error = Update3Errors[keyof Update3Errors];
-export type Update3Responses = {
+export type Update4Error = Update4Errors[keyof Update4Errors];
+export type Update4Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Opaque intent id (prefixed `int_`).
+         * Machine name — the identifier this intent is addressed by.
          */
-        id: string;
-        /**
-         * Machine name — stable identifier used across the API.
-         */
-        intent: string;
+        type: string;
         /**
          * Human-readable label.
          */
@@ -4389,11 +6647,14 @@ export type Update3Responses = {
         };
     };
 };
-export type Update3Response = Update3Responses[keyof Update3Responses];
-export type DeleteOverride2Data = {
+export type Update4Response = Update4Responses[keyof Update4Responses];
+export type DeleteOverride3Data = {
     body?: never;
     path: {
-        id: string;
+        /**
+         * Machine name of the intent (e.g. `refund_request`) — what it is addressed by.
+         */
+        type: string;
     };
     query?: {
         /**
@@ -4401,16 +6662,28 @@ export type DeleteOverride2Data = {
          */
         entityId?: string;
     };
-    url: '/intents/{id}/override';
+    url: '/intents/{type}/override';
 };
-export type DeleteOverride2Errors = {
+export type DeleteOverride3Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4418,9 +6691,21 @@ export type DeleteOverride2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4428,15 +6713,27 @@ export type DeleteOverride2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type DeleteOverride2Error = DeleteOverride2Errors[keyof DeleteOverride2Errors];
-export type DeleteOverride2Responses = {
+export type DeleteOverride3Error = DeleteOverride3Errors[keyof DeleteOverride3Errors];
+export type DeleteOverride3Responses = {
     /**
      * Successful response
      */
@@ -4447,8 +6744,8 @@ export type DeleteOverride2Responses = {
         message: string;
     };
 };
-export type DeleteOverride2Response = DeleteOverride2Responses[keyof DeleteOverride2Responses];
-export type List5Data = {
+export type DeleteOverride3Response = DeleteOverride3Responses[keyof DeleteOverride3Responses];
+export type List6Data = {
     body?: never;
     path?: never;
     query?: {
@@ -4467,14 +6764,26 @@ export type List5Data = {
     };
     url: '/kb';
 };
-export type List5Errors = {
+export type List6Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4482,9 +6791,21 @@ export type List5Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4492,19 +6813,34 @@ export type List5Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type List5Error = List5Errors[keyof List5Errors];
-export type List5Responses = {
+export type List6Error = List6Errors[keyof List6Errors];
+export type List6Responses = {
     /**
      * Successful response
      */
     200: {
+        /**
+         * This page of articles — at most `limit` items, starting at `offset`.
+         */
         articles: Array<{
             /**
              * KB article ID (format: kb_xxxxxxxxxxxx).
@@ -4566,8 +6902,8 @@ export type List5Responses = {
         offset: number;
     };
 };
-export type List5Response = List5Responses[keyof List5Responses];
-export type Create5Data = {
+export type List6Response = List6Responses[keyof List6Responses];
+export type Create6Data = {
     body?: {
         /**
          * Article title.
@@ -4591,14 +6927,26 @@ export type Create5Data = {
     };
     url: '/kb';
 };
-export type Create5Errors = {
+export type Create6Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4606,9 +6954,21 @@ export type Create5Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4616,15 +6976,27 @@ export type Create5Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Create5Error = Create5Errors[keyof Create5Errors];
-export type Create5Responses = {
+export type Create6Error = Create6Errors[keyof Create6Errors];
+export type Create6Responses = {
     /**
      * Successful response
      */
@@ -4714,8 +7086,8 @@ export type Create5Responses = {
         updatedAt: string;
     };
 };
-export type Create5Response = Create5Responses[keyof Create5Responses];
-export type Delete5Data = {
+export type Create6Response = Create6Responses[keyof Create6Responses];
+export type Delete6Data = {
     body?: never;
     path: {
         /**
@@ -4726,14 +7098,26 @@ export type Delete5Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Delete5Errors = {
+export type Delete6Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4741,9 +7125,21 @@ export type Delete5Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4751,15 +7147,27 @@ export type Delete5Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Delete5Error = Delete5Errors[keyof Delete5Errors];
-export type Delete5Responses = {
+export type Delete6Error = Delete6Errors[keyof Delete6Errors];
+export type Delete6Responses = {
     /**
      * Successful response
      */
@@ -4770,8 +7178,8 @@ export type Delete5Responses = {
         message: string;
     };
 };
-export type Delete5Response = Delete5Responses[keyof Delete5Responses];
-export type Get5Data = {
+export type Delete6Response = Delete6Responses[keyof Delete6Responses];
+export type Get6Data = {
     body?: never;
     path: {
         /**
@@ -4782,14 +7190,26 @@ export type Get5Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Get5Errors = {
+export type Get6Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4797,9 +7217,21 @@ export type Get5Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4807,15 +7239,27 @@ export type Get5Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Get5Error = Get5Errors[keyof Get5Errors];
-export type Get5Responses = {
+export type Get6Error = Get6Errors[keyof Get6Errors];
+export type Get6Responses = {
     /**
      * Successful response
      */
@@ -4905,8 +7349,8 @@ export type Get5Responses = {
         updatedAt: string;
     };
 };
-export type Get5Response = Get5Responses[keyof Get5Responses];
-export type Update4Data = {
+export type Get6Response = Get6Responses[keyof Get6Responses];
+export type Update5Data = {
     body?: {
         /**
          * New article title.
@@ -4934,14 +7378,26 @@ export type Update4Data = {
     query?: never;
     url: '/kb/{id}';
 };
-export type Update4Errors = {
+export type Update5Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4949,9 +7405,21 @@ export type Update4Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -4959,15 +7427,27 @@ export type Update4Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Update4Error = Update4Errors[keyof Update4Errors];
-export type Update4Responses = {
+export type Update5Error = Update5Errors[keyof Update5Errors];
+export type Update5Responses = {
     /**
      * Successful response
      */
@@ -5057,7 +7537,7 @@ export type Update4Responses = {
         updatedAt: string;
     };
 };
-export type Update4Response = Update4Responses[keyof Update4Responses];
+export type Update5Response = Update5Responses[keyof Update5Responses];
 export type CreateManyData = {
     body?: {
         /**
@@ -5091,9 +7571,21 @@ export type CreateManyErrors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5101,9 +7593,21 @@ export type CreateManyErrors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5111,9 +7615,21 @@ export type CreateManyErrors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5221,6 +7737,9 @@ export type CreateManyResponses = {
                 updatedAt: string;
             };
         }>;
+        /**
+         * Per-request tally — the counts always add up to `total`.
+         */
         summary: {
             /**
              * Total number of articles in the request.
@@ -5354,6 +7873,9 @@ export type CreateManyResponses = {
              */
             error: string;
         }>;
+        /**
+         * Per-request tally — the counts always add up to `total`.
+         */
         summary: {
             /**
              * Total number of articles in the request.
@@ -5387,9 +7909,21 @@ export type Publish2Errors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5397,9 +7931,21 @@ export type Publish2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5407,9 +7953,21 @@ export type Publish2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5527,9 +8085,21 @@ export type Rollback2Errors = {
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5537,9 +8107,21 @@ export type Rollback2Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5547,9 +8129,21 @@ export type Rollback2Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5646,7 +8240,7 @@ export type Rollback2Responses = {
     };
 };
 export type Rollback2Response = Rollback2Responses[keyof Rollback2Responses];
-export type List6Data = {
+export type List7Data = {
     body?: never;
     path?: never;
     query?: {
@@ -5665,14 +8259,26 @@ export type List6Data = {
     };
     url: '/organizations';
 };
-export type List6Errors = {
+export type List7Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5680,9 +8286,21 @@ export type List6Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5690,19 +8308,34 @@ export type List6Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type List6Error = List6Errors[keyof List6Errors];
-export type List6Responses = {
+export type List7Error = List7Errors[keyof List7Errors];
+export type List7Responses = {
     /**
      * Successful response
      */
     200: {
+        /**
+         * This page of organizations — at most `limit` items, starting at `offset`.
+         */
         organizations: Array<{
             /**
              * Organization ID (format: org_xxxxxxxxxxxx).
@@ -5735,8 +8368,8 @@ export type List6Responses = {
         offset: number;
     };
 };
-export type List6Response = List6Responses[keyof List6Responses];
-export type Create6Data = {
+export type List7Response = List7Responses[keyof List7Responses];
+export type Create7Data = {
     body?: {
         /**
          * Human-readable name of the organization (must be unique).
@@ -5757,14 +8390,26 @@ export type Create6Data = {
     query?: never;
     url: '/organizations';
 };
-export type Create6Errors = {
+export type Create7Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5772,9 +8417,21 @@ export type Create6Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5782,15 +8439,27 @@ export type Create6Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Create6Error = Create6Errors[keyof Create6Errors];
-export type Create6Responses = {
+export type Create7Error = Create7Errors[keyof Create7Errors];
+export type Create7Responses = {
     /**
      * Successful response
      */
@@ -5828,8 +8497,8 @@ export type Create6Responses = {
         apiKey?: string;
     };
 };
-export type Create6Response = Create6Responses[keyof Create6Responses];
-export type Delete6Data = {
+export type Create7Response = Create7Responses[keyof Create7Responses];
+export type Delete7Data = {
     body?: never;
     path: {
         /**
@@ -5840,14 +8509,26 @@ export type Delete6Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Delete6Errors = {
+export type Delete7Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5855,9 +8536,21 @@ export type Delete6Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5865,15 +8558,27 @@ export type Delete6Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Delete6Error = Delete6Errors[keyof Delete6Errors];
-export type Delete6Responses = {
+export type Delete7Error = Delete7Errors[keyof Delete7Errors];
+export type Delete7Responses = {
     /**
      * Successful response
      */
@@ -5884,8 +8589,8 @@ export type Delete6Responses = {
         message: string;
     };
 };
-export type Delete6Response = Delete6Responses[keyof Delete6Responses];
-export type Get6Data = {
+export type Delete7Response = Delete7Responses[keyof Delete7Responses];
+export type Get7Data = {
     body?: never;
     path: {
         /**
@@ -5896,14 +8601,26 @@ export type Get6Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Get6Errors = {
+export type Get7Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5911,9 +8628,21 @@ export type Get6Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5921,15 +8650,27 @@ export type Get6Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Get6Error = Get6Errors[keyof Get6Errors];
-export type Get6Responses = {
+export type Get7Error = Get7Errors[keyof Get7Errors];
+export type Get7Responses = {
     /**
      * Successful response
      */
@@ -5958,8 +8699,8 @@ export type Get6Responses = {
         };
     };
 };
-export type Get6Response = Get6Responses[keyof Get6Responses];
-export type Update5Data = {
+export type Get7Response = Get7Responses[keyof Get7Responses];
+export type Update6Data = {
     body?: {
         /**
          * New name for the organization.
@@ -5981,14 +8722,26 @@ export type Update5Data = {
     query?: never;
     url: '/organizations/{id}';
 };
-export type Update5Errors = {
+export type Update6Errors = {
     /**
      * Bad request
      */
     400: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -5996,9 +8749,21 @@ export type Update5Errors = {
      * Authentication required
      */
     401: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'AUTH';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
@@ -6006,15 +8771,27 @@ export type Update5Errors = {
      * Insufficient permissions
      */
     403: {
+        /**
+         * HTTP status code, repeated in the body.
+         */
         statusCode: number;
+        /**
+         * Error details.
+         */
         error: {
+            /**
+             * Stable, machine-readable error code — branch on this, never on the message.
+             */
             code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            /**
+             * Human-readable explanation. Wording may change; do not parse it.
+             */
             message: string;
         };
     };
 };
-export type Update5Error = Update5Errors[keyof Update5Errors];
-export type Update5Responses = {
+export type Update6Error = Update6Errors[keyof Update6Errors];
+export type Update6Responses = {
     /**
      * Successful response
      */
@@ -6043,5 +8820,5 @@ export type Update5Responses = {
         };
     };
 };
-export type Update5Response = Update5Responses[keyof Update5Responses];
+export type Update6Response = Update6Responses[keyof Update6Responses];
 //# sourceMappingURL=types.gen.d.ts.map