@operla-ai/sdk 0.2.1 → 0.3.1

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

@@ -6,23 +6,11 @@ export type ListData = {
     path?: never;
     query?: {
         /**
-         * Filter: only list conversations linked to this entity.
+         * Target a specific entity (under the caller's organization).
          */
         entityId?: string;
-        /**
-         * Filter: only list conversations in this status.
-         */
-        status?: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
-        /**
-         * Max number of conversations to return (1-100, default 20).
-         */
-        limit?: number;
-        /**
-         * Number of conversations to skip for pagination (default 0).
-         */
-        offset?: number | null;
     };
-    url: '/conversations';
+    url: '/agents';
 };
 export type ListErrors = {
     /**
@@ -62,88 +50,245 @@ export type ListResponses = {
      * Successful response
      */
     200: {
-        /**
-         * Conversations matching the query, sorted by last activity (most recent first).
-         */
-        conversations: Array<{
+        agents: Array<{
+            name: string;
+            label: string;
+            scope: {
+                level: 'global' | 'organization' | 'entity';
+                organizationId?: string;
+                entityId?: string;
+            };
             /**
-             * Conversation ID (format: conv_xxxxxxxxxxxx).
+             * Version of the resolved config at this scope.
              */
-            conversationId: string;
+            version: number;
             /**
-             * Organization linked to the conversation (when you use organizations).
+             * True when an override draft exists at this scope.
              */
+            hasDraft: boolean;
+        }>;
+    };
+};
+export type ListResponse = ListResponses[keyof ListResponses];
+export type CreateData = {
+    body?: {
+        /**
+         * Human-readable label shown in the dashboard. The machine name is derived from this (slugified, prefixed with `specialist_`).
+         */
+        label: string;
+        /**
+         * System prompt for the agent.
+         */
+        prompt: string;
+        /**
+         * Hard rules to attach to the agent at creation.
+         */
+        hardRules?: Array<{
+            name: string;
+            instruction: string;
+            triggers?: {
+                intents?: Array<string>;
+            };
+            priority?: number;
+            disabled?: boolean;
+        }>;
+    };
+    path?: never;
+    query?: never;
+    url: '/agents';
+};
+export type CreateErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type CreateError = CreateErrors[keyof CreateErrors];
+export type CreateResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        name: string;
+        label: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
             organizationId?: string;
-            /**
-             * Current lifecycle status of the conversation.
-             */
-            status: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
-            /**
-             * Short human-readable subject computed from the first messages or the user's identity.
-             */
-            subject: string;
-            /**
-             * The person in the conversation, if identified. Null when no user is known yet.
-             */
-            user: {
-                /**
-                 * Unique identifier of the person in the conversation, in your system.
-                 */
-                userId: string;
-                /**
-                 * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
-                 */
-                resolved?: boolean;
-                /**
-                 * Custom data attached to the user (name, email, account info, etc.).
-                 */
-                data?: {
-                    [key: string]: unknown;
-                };
-            } | null;
-            /**
-             * Entity linked to the conversation (when you use entities).
-             */
             entityId?: string;
-            /**
-             * Total number of messages exchanged so far (user + agent).
-             */
-            messageCount: number;
-            /**
-             * ISO timestamp of the last message, or null if no messages yet.
-             */
-            lastMessageAt: string | null;
-            /**
-             * ISO timestamp when the conversation was created.
-             */
-            createdAt: string;
-            /**
-             * ISO timestamp of the last modification (message, status change, etc.).
-             */
-            updatedAt: string;
-        }>;
+        };
         /**
-         * Total number of conversations matching the query (across all pages).
+         * The agent config the runtime sees at the request scope, after cascade resolution.
          */
-        total: number;
+        resolved: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
         /**
-         * Page size applied to this response.
+         * Override draft at this scope, when one exists.
          */
-        limit: number;
+        draft?: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+    };
+};
+export type CreateResponse = CreateResponses[keyof CreateResponses];
+export type DeleteData = {
+    body?: never;
+    path: {
         /**
-         * Offset applied to this response.
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
          */
-        offset: number;
+        name: string;
     };
+    query?: never;
+    url: '/agents/{name}';
 };
-export type ListResponse = ListResponses[keyof ListResponses];
+export type DeleteErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type DeleteError = DeleteErrors[keyof DeleteErrors];
+export type DeleteResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        message: string;
+    };
+};
+export type DeleteResponse = DeleteResponses[keyof DeleteResponses];
 export type GetData = {
     body?: never;
     path: {
-        conversationId: string;
+        /**
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
+        name: string;
     };
-    query?: never;
-    url: '/conversations/{conversationId}';
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/agents/{name}';
 };
 export type GetErrors = {
     /**
@@ -152,7 +297,7 @@ export type GetErrors = {
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG';
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
             message: string;
         };
     };
@@ -183,159 +328,1531 @@ export type GetResponses = {
      * Successful response
      */
     200: {
+        name: string;
+        label: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
         /**
-         * Conversation ID (format: conv_xxxxxxxxxxxx).
+         * The agent config the runtime sees at the request scope, after cascade resolution.
          */
-        conversationId: string;
+        resolved: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
         /**
-         * Organization linked to the conversation (when you use organizations).
+         * Override draft at this scope, when one exists.
          */
-        organizationId?: string;
+        draft?: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+    };
+};
+export type GetResponse = GetResponses[keyof GetResponses];
+export type UpdateData = {
+    body?: {
         /**
-         * Current lifecycle status of the conversation.
+         * System prompt for the agent.
          */
-        status: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
+        prompt?: string;
         /**
-         * Short human-readable subject computed from the first messages or the user's identity.
+         * Hard rules enforced after the LLM call. Names act as merge keys when overriding the cascade.
          */
-        subject: string;
+        hardRules?: Array<{
+            name: string;
+            instruction: string;
+            triggers?: {
+                intents?: Array<string>;
+            };
+            priority?: number;
+            disabled?: boolean;
+        }>;
         /**
-         * The person in the conversation, if identified. Null when no user is known yet.
+         * Toggle which user-context fields are exposed to the agent.
          */
-        user: {
-            /**
-             * Unique identifier of the person in the conversation, in your system.
-             */
-            userId: string;
-            /**
-             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
-             */
-            resolved?: boolean;
-            /**
-             * Custom data attached to the user (name, email, account info, etc.).
-             */
-            data?: {
-                [key: string]: unknown;
-            };
-        } | null;
+        userContextConfig?: {
+            [key: string]: boolean;
+        };
         /**
-         * Entity linked to the conversation (when you use entities).
+         * Per-channel writing style. Only meaningful on the response agent. Sparse: omitted fields inherit from the cascade.
          */
-        entityId?: string;
+        responseConfig?: {
+            email?: {
+                greeting?: string;
+                signature?: string;
+                tone?: 'empathetic' | 'formal' | 'friendly';
+                addressForm?: 'formal' | 'informal';
+                allowEmojis?: boolean;
+            };
+            chat?: {
+                greeting?: string;
+                signature?: string;
+                tone?: 'empathetic' | 'formal' | 'friendly';
+                addressForm?: 'formal' | 'informal';
+                allowEmojis?: boolean;
+            };
+        };
         /**
-         * Total number of messages exchanged so far (user + agent).
+         * When true, the changes are written to draft and immediately promoted to published (a version snapshot is still created so rollback remains possible). When false (default), the changes stay in draft until you publish them via the dashboard.
          */
-        messageCount: number;
+        publish?: boolean;
+    };
+    path: {
         /**
-         * ISO timestamp of the last message, or null if no messages yet.
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
          */
-        lastMessageAt: string | null;
+        name: string;
+    };
+    query?: {
         /**
-         * ISO timestamp when the conversation was created.
+         * Target a specific entity (under the caller's organization).
          */
-        createdAt: string;
+        entityId?: string;
+    };
+    url: '/agents/{name}';
+};
+export type UpdateErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type UpdateError = UpdateErrors[keyof UpdateErrors];
+export type UpdateResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        name: string;
+        label: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
         /**
-         * ISO timestamp of the last modification (message, status change, etc.).
+         * The agent config the runtime sees at the request scope, after cascade resolution.
          */
-        updatedAt: string;
+        resolved: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
         /**
-         * Full message history in chronological order.
+         * Override draft at this scope, when one exists.
          */
-        thread: Array<{
-            /**
-             * Who emitted the message — the user or your AI agent.
-             */
-            role: 'user' | 'agent';
-            /**
-             * Message body.
-             */
-            content: string;
-            /**
-             * ISO timestamp when the message was recorded.
-             */
-            timestamp: string;
-            /**
-             * Display name of the author (when available).
-             */
-            authorName?: string;
-        }>;
+        draft?: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+    };
+};
+export type UpdateResponse = UpdateResponses[keyof UpdateResponses];
+export type DeleteOverrideData = {
+    body?: never;
+    path: {
         /**
-         * Origin tag provided when the conversation was created.
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
          */
-        source?: string;
+        name: string;
+    };
+    query?: {
         /**
-         * Cross-reference ID in your external ticketing system (e.g. Zendesk), when applicable.
+         * Target a specific entity (under the caller's organization).
          */
-        externalTicketId?: string;
+        entityId?: string;
     };
+    url: '/agents/{name}/overrides';
 };
-export type GetResponse = GetResponses[keyof GetResponses];
-export type SendMessageData = {
+export type DeleteOverrideErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type DeleteOverrideError = DeleteOverrideErrors[keyof DeleteOverrideErrors];
+export type DeleteOverrideResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        message: string;
+    };
+};
+export type DeleteOverrideResponse = DeleteOverrideResponses[keyof DeleteOverrideResponses];
+export type PublishData = {
     body?: {
         /**
-         * Message text sent by the user.
+         * Optional changelog message attached to the new version.
          */
-        message: string;
+        message?: string;
+    };
+    path: {
         /**
-         * Conversation ID (format: conv_xxxxxxxxxxxx). Omit on the first call — the server generates one and returns it.
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
          */
-        conversationId?: string;
+        name: string;
+    };
+    query?: {
         /**
-         * Link the conversation to an entity (only applied when creating the conversation; ignored on subsequent messages for the same conversationId).
+         * Target a specific entity (under the caller's organization).
          */
         entityId?: string;
+    };
+    url: '/agents/{name}/publish';
+};
+export type PublishErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type PublishError = PublishErrors[keyof PublishErrors];
+export type PublishResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        name: string;
+        label: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
         /**
-         * The user sending the message. Set `resolved: true` on the user object to skip identity resolution when you already have a complete profile.
+         * The agent config the runtime sees at the request scope, after cascade resolution.
          */
-        user?: {
-            /**
-             * Unique identifier of the person in the conversation, in your system.
-             */
-            userId: string;
-            /**
-             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
-             */
-            resolved?: boolean;
-            /**
-             * Custom data attached to the user (name, email, account info, etc.).
-             */
-            data?: {
-                [key: string]: unknown;
+        resolved: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
             };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
         };
         /**
-         * Overrides the configured KBs for this message. Not stored.
+         * Override draft at this scope, when one exists.
          */
-        kbArticles?: Array<{
-            /**
-             * Article title shown to the agent.
-             */
-            title: string;
-            /**
-             * Article body (markdown-friendly).
-             */
-            content: string;
-            /**
-             * Intent identifiers this article serves. Empty or omitted = always-on. Otherwise the article is only injected when one of these intents is detected on the message.
-             */
-            intents?: Array<string>;
-        }>;
+        draft?: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+    };
+};
+export type PublishResponse = PublishResponses[keyof PublishResponses];
+export type RollbackData = {
+    body?: {
+        /**
+         * Archived version number to restore as the new published.
+         */
+        targetVersion: number;
+    };
+    path: {
+        /**
+         * Agent name (e.g. `orchestrator`, `response`, `specialist_billing`).
+         */
+        name: string;
+    };
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+    };
+    url: '/agents/{name}/rollback';
+};
+export type RollbackErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type RollbackError = RollbackErrors[keyof RollbackErrors];
+export type RollbackResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        name: string;
+        label: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        /**
+         * The agent config the runtime sees at the request scope, after cascade resolution.
+         */
+        resolved: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        /**
+         * Override draft at this scope, when one exists.
+         */
+        draft?: {
+            version: number;
+            prompt?: string;
+            hardRules?: Array<{
+                name: string;
+                instruction: string;
+                triggers?: {
+                    intents?: Array<string>;
+                };
+                priority?: number;
+                disabled?: boolean;
+            }>;
+            userContextConfig?: {
+                [key: string]: boolean;
+            };
+            responseConfig?: {
+                email?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+                chat?: {
+                    greeting?: string;
+                    signature?: string;
+                    tone?: 'empathetic' | 'formal' | 'friendly';
+                    addressForm?: 'formal' | 'informal';
+                    allowEmojis?: boolean;
+                };
+            };
+            message?: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+    };
+};
+export type RollbackResponse = RollbackResponses[keyof RollbackResponses];
+export type List2Data = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Max number of items to return per page (1-100).
+         */
+        limit?: number;
+        /**
+         * Number of items to skip for pagination.
+         */
+        offset?: number | null;
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
+        /**
+         * Only list conversations in this status.
+         */
+        status?: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
+    };
+    url: '/conversations';
+};
+export type List2Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type List2Error = List2Errors[keyof List2Errors];
+export type List2Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        conversations: Array<{
+            /**
+             * Conversation ID (format: conv_xxxxxxxxxxxx).
+             */
+            conversationId: string;
+            /**
+             * Organization linked to the conversation (when you use organizations).
+             */
+            organizationId?: string;
+            /**
+             * Current lifecycle status of the conversation.
+             */
+            status: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
+            /**
+             * Short human-readable subject computed from the first messages or the user's identity.
+             */
+            subject: string;
+            /**
+             * The person in the conversation, if identified. Null when no user is known yet. Custom user `data` is omitted here — fetch a single conversation to get it.
+             */
+            user: {
+                /**
+                 * Unique identifier of the person in the conversation, in your system.
+                 */
+                userId: string;
+                /**
+                 * Whether the user is fully identified.
+                 */
+                resolved?: boolean;
+            } | null;
+            /**
+             * Entity linked to the conversation (when you use entities).
+             */
+            entityId?: string;
+            /**
+             * Total number of messages exchanged so far (user + agent).
+             */
+            messageCount: number;
+            /**
+             * ISO timestamp of the last message, or null if no messages yet.
+             */
+            lastMessageAt: string | null;
+            /**
+             * ISO timestamp when the conversation was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last modification (message, status change, etc.).
+             */
+            updatedAt: string;
+        }>;
+        /**
+         * Total number of items matching the query.
+         */
+        total: number;
+        /**
+         * Page size applied to this response.
+         */
+        limit: number;
+        /**
+         * Offset applied to this response.
+         */
+        offset: number;
+    };
+};
+export type List2Response = List2Responses[keyof List2Responses];
+export type Get2Data = {
+    body?: never;
+    path: {
+        /**
+         * Conversation ID (format: `conv_xxxxxxxxxxxx`).
+         */
+        conversationId: string;
+    };
+    query?: never;
+    url: '/conversations/{conversationId}';
+};
+export type Get2Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Get2Error = Get2Errors[keyof Get2Errors];
+export type Get2Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Conversation ID (format: conv_xxxxxxxxxxxx).
+         */
+        conversationId: string;
+        /**
+         * Organization linked to the conversation (when you use organizations).
+         */
+        organizationId?: string;
+        /**
+         * Current lifecycle status of the conversation.
+         */
+        status: 'pending' | 'processing' | 'awaiting_validation' | 'awaiting_user' | 'resolved' | 'closed' | 'failed' | 'escalated' | 'spam';
+        /**
+         * Short human-readable subject computed from the first messages or the user's identity.
+         */
+        subject: string;
+        /**
+         * The person in the conversation, if identified. Null when no user is known yet.
+         */
+        user: {
+            /**
+             * Unique identifier of the person in the conversation, in your system.
+             */
+            userId: string;
+            /**
+             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
+             */
+            resolved?: boolean;
+            /**
+             * Custom data attached to the user (name, email, account info, etc.).
+             */
+            data?: {
+                [key: string]: unknown;
+            };
+        } | null;
+        /**
+         * Entity linked to the conversation (when you use entities).
+         */
+        entityId?: string;
+        /**
+         * Total number of messages exchanged so far (user + agent).
+         */
+        messageCount: number;
+        /**
+         * ISO timestamp of the last message, or null if no messages yet.
+         */
+        lastMessageAt: string | null;
+        /**
+         * ISO timestamp when the conversation was created.
+         */
+        createdAt: string;
+        /**
+         * ISO timestamp of the last modification (message, status change, etc.).
+         */
+        updatedAt: string;
+        /**
+         * Full message history in chronological order.
+         */
+        thread: Array<{
+            /**
+             * Who emitted the message — the user or your AI agent.
+             */
+            role: 'user' | 'agent';
+            /**
+             * Message body.
+             */
+            content: string;
+            /**
+             * ISO timestamp when the message was recorded.
+             */
+            timestamp: string;
+            /**
+             * Display name of the author (when available).
+             */
+            authorName?: string;
+        }>;
+        /**
+         * Origin tag provided when the conversation was created.
+         */
+        source?: string;
+        /**
+         * Cross-reference ID in your external ticketing system (e.g. Zendesk), when applicable.
+         */
+        externalTicketId?: string;
+    };
+};
+export type Get2Response = Get2Responses[keyof Get2Responses];
+export type SendMessageData = {
+    body?: {
+        /**
+         * Message text sent by the user.
+         */
+        message: string;
+        /**
+         * Conversation ID (format: conv_xxxxxxxxxxxx). Omit on the first call — the server generates one and returns it.
+         */
+        conversationId?: string;
+        /**
+         * Link the conversation to an entity (only applied when creating the conversation; ignored on subsequent messages for the same conversationId).
+         */
+        entityId?: string;
+        /**
+         * The user sending the message. Set `resolved: true` on the user object to skip identity resolution when you already have a complete profile.
+         */
+        user?: {
+            /**
+             * Unique identifier of the person in the conversation, in your system.
+             */
+            userId: string;
+            /**
+             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
+             */
+            resolved?: boolean;
+            /**
+             * Custom data attached to the user (name, email, account info, etc.).
+             */
+            data?: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * Overrides the configured KBs for this message. Not stored.
+         */
+        kbArticles?: Array<{
+            /**
+             * Article title shown to the agent.
+             */
+            title: string;
+            /**
+             * Article body (markdown-friendly).
+             */
+            content: string;
+            /**
+             * Intent identifiers this article serves. Empty or omitted = always-on. Otherwise the article is only injected when one of these intents is detected on the message.
+             */
+            intents?: Array<string>;
+        }>;
+        /**
+         * Origin tag for the conversation (e.g. "website", "chat_page"). Stored on the conversation for analytics.
+         */
+        source?: string;
+        /**
+         * Custom key/value pairs attached to the conversation. Available as variables in your agent prompts.
+         */
+        metadata?: {
+            [key: string]: string;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/conversations/messages';
+};
+export type SendMessageErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type SendMessageError = SendMessageErrors[keyof SendMessageErrors];
+export type SendMessageResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Conversation ID — pass it back on subsequent calls to continue the conversation.
+         */
+        conversationId: string;
+        /**
+         * Organization linked to the conversation (when you use organizations).
+         */
+        organizationId?: string;
+        /**
+         * Index of the user message that was just processed. Pass this to [`validateResponse`](#tag/conversations/POST/conversations/{conversationId}/validate-response) if `mode` is `copilot` and you need to validate the response later.
+         */
+        messageIndex: number;
+        /**
+         * The person in the conversation, if identified. Null when no user is known yet.
+         */
+        user: {
+            /**
+             * Unique identifier of the person in the conversation, in your system.
+             */
+            userId: string;
+            /**
+             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
+             */
+            resolved?: boolean;
+            /**
+             * Custom data attached to the user (name, email, account info, etc.).
+             */
+            data?: {
+                [key: string]: unknown;
+            };
+        } | null;
+        /**
+         * Entity linked to the conversation (when you use entities).
+         */
+        entityId?: string;
+        /**
+         * AI-generated response to the user message.
+         */
+        content: string;
+        /**
+         * How the AI labels this response. `autopilot`: every involved intent and action is cleared for automation — safe to send the content as-is. `copilot`: at least one intent or action is configured for human review — hold the content for an agent to validate before sending. The actual delivery is up to you.
+         */
+        mode: 'autopilot' | 'copilot';
+        /**
+         * True when the conversation has been escalated to a human agent (hard-rule trigger, action failure, unidentifiable user, message limit reached, etc.). The `content` is then a notice for the user that their request was forwarded.
+         */
+        escalated: boolean;
+    };
+};
+export type SendMessageResponse = SendMessageResponses[keyof SendMessageResponses];
+export type ValidateResponseData = {
+    body?: {
+        /**
+         * Index of the user message whose AI response should be validated.
+         */
+        messageIndex: number;
+        /**
+         * Edited content to send instead of the original AI response. Omit to deliver the AI response as-is.
+         */
+        editedContent?: string;
+    };
+    path: {
+        /**
+         * Conversation ID (format: `conv_xxxxxxxxxxxx`).
+         */
+        conversationId: string;
+    };
+    query?: never;
+    url: '/conversations/{conversationId}/validate-response';
+};
+export type ValidateResponseErrors = {
+    /**
+     * The response cannot be validated in its current state.
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON' | 'ALREADY_VALIDATED' | 'NO_RESPONSE';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+    /**
+     * Conversation or message at the given index does not exist.
+     */
+    404: {
+        statusCode: number;
+        error: {
+            code: 'NOT-FOUND';
+            message: string;
+        };
+    };
+};
+export type ValidateResponseError = ValidateResponseErrors[keyof ValidateResponseErrors];
+export type ValidateResponseResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Outcome of every action attached to the response that was executed at validation time.
+         */
+        actionsExecuted: Array<{
+            /**
+             * Action type identifier.
+             */
+            type: string;
+            /**
+             * Whether the action ran successfully.
+             */
+            success: boolean;
+            /**
+             * Error message when the action failed.
+             */
+            error?: string;
+        }>;
+    };
+};
+export type ValidateResponseResponse = ValidateResponseResponses[keyof ValidateResponseResponses];
+export type AppendMessageData = {
+    body?: {
+        /**
+         * Message text to append to the conversation thread.
+         */
+        content: string;
+        /**
+         * Who the message is attributed to. `user` to inject an end-user message; `agent` for an operator/human-agent reply that should appear alongside AI responses.
+         */
+        role: 'user' | 'agent';
+        /**
+         * Display name shown alongside the message (e.g. "Alice"). Falls back to the role's default when omitted.
+         */
+        authorName?: string;
+    };
+    path: {
+        /**
+         * Conversation ID (format: `conv_xxxxxxxxxxxx`).
+         */
+        conversationId: string;
+    };
+    query?: never;
+    url: '/conversations/{conversationId}/messages';
+};
+export type AppendMessageErrors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+    /**
+     * Conversation does not exist.
+     */
+    404: {
+        statusCode: number;
+        error: {
+            code: 'NOT-FOUND';
+            message: string;
+        };
+    };
+};
+export type AppendMessageError = AppendMessageErrors[keyof AppendMessageErrors];
+export type AppendMessageResponses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Index of the appended message in the conversation thread.
+         */
+        messageIndex: number;
+    };
+};
+export type AppendMessageResponse = AppendMessageResponses[keyof AppendMessageResponses];
+export type List3Data = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Max number of items to return per page (1-100).
+         */
+        limit?: number;
+        /**
+         * Number of items to skip for pagination.
+         */
+        offset?: number | null;
+    };
+    url: '/entities';
+};
+export type List3Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type List3Error = List3Errors[keyof List3Errors];
+export type List3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        entities: Array<{
+            /**
+             * Entity ID (format: ent_xxxxxxxxxxxx).
+             */
+            id: string;
+            organizationId?: string | null;
+            /**
+             * Human-readable name of the entity.
+             */
+            name: string;
+            /**
+             * ISO timestamp when the entity was created.
+             */
+            createdAt: string;
+            /**
+             * ISO timestamp of the last update.
+             */
+            updatedAt: string;
+        }>;
+        /**
+         * Total number of items matching the query.
+         */
+        total: number;
+        /**
+         * Page size applied to this response.
+         */
+        limit: number;
+        /**
+         * Offset applied to this response.
+         */
+        offset: number;
+    };
+};
+export type List3Response = List3Responses[keyof List3Responses];
+export type Create2Data = {
+    body?: {
+        /**
+         * Human-readable name of the entity.
+         */
+        name: string;
+        /**
+         * Free-form metadata attached to the entity (shape is up to you).
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/entities';
+};
+export type Create2Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Create2Error = Create2Errors[keyof Create2Errors];
+export type Create2Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Entity ID (format: ent_xxxxxxxxxxxx).
+         */
+        id: string;
+        organizationId?: string | null;
+        /**
+         * Human-readable name of the entity.
+         */
+        name: string;
+        /**
+         * ISO timestamp when the entity was created.
+         */
+        createdAt: string;
+        /**
+         * ISO timestamp of the last update.
+         */
+        updatedAt: string;
+        /**
+         * Free-form metadata attached to the entity (shape is up to you).
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
+    };
+};
+export type Create2Response = Create2Responses[keyof Create2Responses];
+export type Delete2Data = {
+    body?: never;
+    path: {
+        /**
+         * Entity ID (format: `ent_xxxxxxxxxxxx`).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/entities/{id}';
+};
+export type Delete2Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Delete2Error = Delete2Errors[keyof Delete2Errors];
+export type Delete2Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Confirmation message.
+         */
+        message: string;
+    };
+};
+export type Delete2Response = Delete2Responses[keyof Delete2Responses];
+export type Get3Data = {
+    body?: never;
+    path: {
+        /**
+         * Entity ID (format: `ent_xxxxxxxxxxxx`).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/entities/{id}';
+};
+export type Get3Errors = {
+    /**
+     * Bad request
+     */
+    400: {
+        statusCode: number;
+        error: {
+            code: 'MISSING-ORG';
+            message: string;
+        };
+    };
+    /**
+     * Authentication required
+     */
+    401: {
+        statusCode: number;
+        error: {
+            code: 'AUTH';
+            message: string;
+        };
+    };
+    /**
+     * Insufficient permissions
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
+    };
+};
+export type Get3Error = Get3Errors[keyof Get3Errors];
+export type Get3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        /**
+         * Entity ID (format: ent_xxxxxxxxxxxx).
+         */
+        id: string;
+        organizationId?: string | null;
+        /**
+         * Human-readable name of the entity.
+         */
+        name: string;
+        /**
+         * ISO timestamp when the entity was created.
+         */
+        createdAt: string;
         /**
-         * Origin tag for the conversation (e.g. "website", "chat_page"). Stored on the conversation for analytics.
+         * ISO timestamp of the last update.
          */
-        source?: string;
+        updatedAt: string;
         /**
-         * Custom key/value pairs attached to the conversation. Available as variables in your agent prompts.
+         * Free-form metadata attached to the entity (shape is up to you).
          */
         metadata?: {
-            [key: string]: string;
+            [key: string]: unknown;
         };
     };
-    path?: never;
+};
+export type Get3Response = Get3Responses[keyof Get3Responses];
+export type Update2Data = {
+    body?: {
+        /**
+         * New name for the entity.
+         */
+        name?: string;
+        /**
+         * Replace the free-form metadata attached to the entity.
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
+    };
+    path: {
+        /**
+         * Entity ID (format: `ent_xxxxxxxxxxxx`).
+         */
+        id: string;
+    };
     query?: never;
-    url: '/conversations/messages';
+    url: '/entities/{id}';
 };
-export type SendMessageErrors = {
+export type Update2Errors = {
     /**
      * Bad request
      */
@@ -367,87 +1884,65 @@ export type SendMessageErrors = {
         };
     };
 };
-export type SendMessageError = SendMessageErrors[keyof SendMessageErrors];
-export type SendMessageResponses = {
+export type Update2Error = Update2Errors[keyof Update2Errors];
+export type Update2Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Conversation ID — pass it back on subsequent calls to continue the conversation.
-         */
-        conversationId: string;
-        /**
-         * Organization linked to the conversation (when you use organizations).
-         */
-        organizationId?: string;
-        /**
-         * Index of the user message that was just processed. Pass this to [`validateResponse`](#tag/conversations/POST/conversations/{conversationId}/validate-response) if `mode` is `copilot` and you need to validate the response later.
-         */
-        messageIndex: number;
-        /**
-         * The person in the conversation, if identified. Null when no user is known yet.
+         * Entity ID (format: ent_xxxxxxxxxxxx).
          */
-        user: {
-            /**
-             * Unique identifier of the person in the conversation, in your system.
-             */
-            userId: string;
-            /**
-             * Whether the user is fully identified. Pass `true` to skip user resolution (you have a complete profile); pass `false` (or omit) to have us verify identity from the message. In responses, reflects the current state.
-             */
-            resolved?: boolean;
-            /**
-             * Custom data attached to the user (name, email, account info, etc.).
-             */
-            data?: {
-                [key: string]: unknown;
-            };
-        } | null;
+        id: string;
+        organizationId?: string | null;
         /**
-         * Entity linked to the conversation (when you use entities).
+         * Human-readable name of the entity.
          */
-        entityId?: string;
+        name: string;
         /**
-         * AI-generated response to the user message.
+         * ISO timestamp when the entity was created.
          */
-        content: string;
+        createdAt: string;
         /**
-         * How the AI labels this response. `autopilot`: every involved intent and action is cleared for automation — safe to send the content as-is. `copilot`: at least one intent or action is configured for human review — hold the content for an agent to validate before sending. The actual delivery is up to you.
+         * ISO timestamp of the last update.
          */
-        mode: 'autopilot' | 'copilot';
+        updatedAt: string;
         /**
-         * True when the conversation has been escalated to a human agent (hard-rule trigger, action failure, unidentifiable user, message limit reached, etc.). The `content` is then a notice for the user that their request was forwarded.
+         * Free-form metadata attached to the entity (shape is up to you).
          */
-        escalated: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
     };
 };
-export type SendMessageResponse = SendMessageResponses[keyof SendMessageResponses];
-export type ValidateResponseData = {
-    body?: {
+export type Update2Response = Update2Responses[keyof Update2Responses];
+export type List4Data = {
+    body?: never;
+    path?: never;
+    query?: {
         /**
-         * Index of the user message whose AI response should be validated.
+         * Max number of items to return per page (1-100).
          */
-        messageIndex: number;
+        limit?: number;
         /**
-         * Edited content to send instead of the original AI response. Omit to deliver the AI response as-is.
+         * Number of items to skip for pagination.
          */
-        editedContent?: string;
-    };
-    path: {
-        conversationId: string;
+        offset?: number | null;
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
     };
-    query?: never;
-    url: '/conversations/{conversationId}/validate-response';
+    url: '/kb';
 };
-export type ValidateResponseErrors = {
+export type List4Errors = {
     /**
-     * The response cannot be validated in its current state.
+     * Bad request
      */
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON' | 'ALREADY_VALIDATED' | 'NO_RESPONSE';
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
             message: string;
         };
     };
@@ -471,65 +1966,67 @@ export type ValidateResponseErrors = {
             message: string;
         };
     };
-    /**
-     * Conversation or message at the given index does not exist.
-     */
-    404: {
-        statusCode: number;
-        error: {
-            code: 'NOT-FOUND';
-            message: string;
-        };
-    };
 };
-export type ValidateResponseError = ValidateResponseErrors[keyof ValidateResponseErrors];
-export type ValidateResponseResponses = {
+export type List4Error = List4Errors[keyof List4Errors];
+export type List4Responses = {
     /**
      * Successful response
      */
     200: {
+        articles: Array<{
+            id: string;
+            title: string;
+            intents: Array<string>;
+            scope: {
+                level: 'global' | 'organization' | 'entity';
+                organizationId?: string;
+                entityId?: string;
+            };
+            version: number;
+            hasDraft: boolean;
+            publishedAt?: string;
+            updatedAt: string;
+        }>;
         /**
-         * Outcome of every action attached to the response that was executed at validation time.
+         * Total number of items matching the query.
          */
-        actionsExecuted: Array<{
-            /**
-             * Action type identifier.
-             */
-            type: string;
-            /**
-             * Whether the action ran successfully.
-             */
-            success: boolean;
-            /**
-             * Error message when the action failed.
-             */
-            error?: string;
-        }>;
+        total: number;
+        /**
+         * Page size applied to this response.
+         */
+        limit: number;
+        /**
+         * Offset applied to this response.
+         */
+        offset: number;
     };
 };
-export type ValidateResponseResponse = ValidateResponseResponses[keyof ValidateResponseResponses];
-export type AppendMessageData = {
+export type List4Response = List4Responses[keyof List4Responses];
+export type Create3Data = {
     body?: {
         /**
-         * Message text to append to the conversation thread.
+         * Article title.
          */
-        content: string;
+        title: string;
         /**
-         * Who the message is attributed to. `user` to inject an end-user message; `agent` for an operator/human-agent reply that should appear alongside AI responses.
+         * Article body (Markdown).
          */
-        role: 'user' | 'agent';
+        content: string;
         /**
-         * Display name shown alongside the message (e.g. "Alice"). Falls back to the role's default when omitted.
+         * Intent IDs this article serves. Empty = always-on within its scope.
          */
-        authorName?: string;
+        intents?: Array<string>;
     };
-    path: {
-        conversationId: string;
+    path?: never;
+    query?: {
+        /**
+         * Target a specific entity (under the caller's organization).
+         */
+        entityId?: string;
     };
-    query?: never;
-    url: '/conversations/{conversationId}/messages';
+    url: '/kb';
 };
-export type AppendMessageErrors = {
+export type Create3Errors = {
     /**
      * Bad request
      */
@@ -560,49 +2057,61 @@ export type AppendMessageErrors = {
             message: string;
         };
     };
-    /**
-     * Conversation does not exist.
-     */
-    404: {
-        statusCode: number;
-        error: {
-            code: 'NOT-FOUND';
-            message: string;
-        };
-    };
 };
-export type AppendMessageError = AppendMessageErrors[keyof AppendMessageErrors];
-export type AppendMessageResponses = {
+export type Create3Error = Create3Errors[keyof Create3Errors];
+export type Create3Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Index of the appended message in the conversation thread.
+         * KB article ID (format: kb_xxxxxxxxxxxx).
          */
-        messageIndex: number;
+        id: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        intents: Array<string>;
+        published: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        draft?: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        createdAt: string;
+        updatedAt: string;
     };
 };
-export type AppendMessageResponse = AppendMessageResponses[keyof AppendMessageResponses];
-export type List2Data = {
+export type Create3Response = Create3Responses[keyof Create3Responses];
+export type Delete3Data = {
     body?: never;
-    path?: never;
-    query?: {
+    path: {
         /**
-         * Filter: only list entities under this organization (when you use organizations).
+         * KB article ID (format: `kb_xxxxxxxxxxxx`).
          */
-        organizationId?: string;
+        id: string;
     };
-    url: '/entities';
+    query?: never;
+    url: '/kb/{id}';
 };
-export type List2Errors = {
+export type Delete3Errors = {
     /**
      * Bad request
      */
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            code: 'MISSING-ORG';
             message: string;
         };
     };
@@ -618,81 +2127,44 @@ export type List2Errors = {
     };
     /**
      * Insufficient permissions
-     */
-    403: {
-        statusCode: number;
-        error: {
-            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
-            message: string;
-        };
-    };
-};
-export type List2Error = List2Errors[keyof List2Errors];
-export type List2Responses = {
-    /**
-     * Successful response
-     */
-    200: {
-        /**
-         * Entities matching the query.
-         */
-        entities: Array<{
-            /**
-             * Entity ID (format: ent_xxxxxxxxxxxx).
-             */
-            id: string;
-            organizationId?: string | null;
-            /**
-             * Human-readable name of the entity.
-             */
-            name: string;
-            /**
-             * Free-form metadata attached to the entity (shape is up to you).
-             */
-            metadata?: {
-                [key: string]: unknown;
-            };
-            /**
-             * ISO timestamp when the entity was created.
-             */
-            createdAt: string;
-            /**
-             * ISO timestamp of the last update.
-             */
-            updatedAt: string;
-        }>;
-        /**
-         * Total number of entities matching the query.
-         */
-        total: number;
+     */
+    403: {
+        statusCode: number;
+        error: {
+            code: 'FORBIDDEN' | 'SCOPE-FORBIDDEN';
+            message: string;
+        };
     };
 };
-export type List2Response = List2Responses[keyof List2Responses];
-export type CreateData = {
-    body?: {
-        /**
-         * Human-readable name of the entity.
-         */
-        name: string;
+export type Delete3Error = Delete3Errors[keyof Delete3Errors];
+export type Delete3Responses = {
+    /**
+     * Successful response
+     */
+    200: {
+        message: string;
+    };
+};
+export type Delete3Response = Delete3Responses[keyof Delete3Responses];
+export type Get4Data = {
+    body?: never;
+    path: {
         /**
-         * Free-form metadata attached to the entity (shape is up to you).
+         * KB article ID (format: `kb_xxxxxxxxxxxx`).
          */
-        metadata?: {
-            [key: string]: unknown;
-        };
+        id: string;
     };
-    path?: never;
     query?: never;
-    url: '/entities';
+    url: '/kb/{id}';
 };
-export type CreateErrors = {
+export type Get4Errors = {
     /**
      * Bad request
      */
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
+            code: 'MISSING-ORG';
             message: string;
         };
     };
@@ -717,54 +2189,77 @@ export type CreateErrors = {
         };
     };
 };
-export type CreateError = CreateErrors[keyof CreateErrors];
-export type CreateResponses = {
+export type Get4Error = Get4Errors[keyof Get4Errors];
+export type Get4Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Entity ID (format: ent_xxxxxxxxxxxx).
+         * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
-        organizationId?: string | null;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        intents: Array<string>;
+        published: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        draft?: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        createdAt: string;
+        updatedAt: string;
+    };
+};
+export type Get4Response = Get4Responses[keyof Get4Responses];
+export type Update3Data = {
+    body?: {
         /**
-         * Human-readable name of the entity.
+         * New article title.
          */
-        name: string;
+        title?: string;
         /**
-         * Free-form metadata attached to the entity (shape is up to you).
+         * New article body.
          */
-        metadata?: {
-            [key: string]: unknown;
-        };
+        content?: string;
         /**
-         * ISO timestamp when the entity was created.
+         * Replace the intents list. Pass `[]` to make the article always-on.
          */
-        createdAt: string;
+        intents?: Array<string>;
         /**
-         * ISO timestamp of the last update.
+         * When true and `title`/`content` is provided, the changes are written to draft and immediately promoted to published (a version snapshot is still created so rollback remains possible). When false (default), the content stays in draft. Routing changes (`intents`) bypass this flag.
          */
-        updatedAt: string;
+        publish?: boolean;
     };
-};
-export type CreateResponse = CreateResponses[keyof CreateResponses];
-export type DeleteData = {
-    body?: never;
     path: {
+        /**
+         * KB article ID (format: `kb_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
-    url: '/entities/{id}';
+    url: '/kb/{id}';
 };
-export type DeleteErrors = {
+export type Update3Errors = {
     /**
      * Bad request
      */
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG';
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
             message: string;
         };
     };
@@ -789,28 +2284,53 @@ export type DeleteErrors = {
         };
     };
 };
-export type DeleteError = DeleteErrors[keyof DeleteErrors];
-export type DeleteResponses = {
+export type Update3Error = Update3Errors[keyof Update3Errors];
+export type Update3Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Confirmation message.
+         * KB article ID (format: kb_xxxxxxxxxxxx).
          */
-        message: string;
+        id: string;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        intents: Array<string>;
+        published: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        draft?: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        createdAt: string;
+        updatedAt: string;
     };
 };
-export type DeleteResponse = DeleteResponses[keyof DeleteResponses];
-export type Get2Data = {
+export type Update3Response = Update3Responses[keyof Update3Responses];
+export type Publish2Data = {
     body?: never;
     path: {
+        /**
+         * KB article ID (format: `kb_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
-    url: '/entities/{id}';
+    url: '/kb/{id}/publish';
 };
-export type Get2Errors = {
+export type Publish2Errors = {
     /**
      * Bad request
      */
@@ -842,58 +2362,58 @@ export type Get2Errors = {
         };
     };
 };
-export type Get2Error = Get2Errors[keyof Get2Errors];
-export type Get2Responses = {
+export type Publish2Error = Publish2Errors[keyof Publish2Errors];
+export type Publish2Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Entity ID (format: ent_xxxxxxxxxxxx).
+         * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
-        organizationId?: string | null;
-        /**
-         * Human-readable name of the entity.
-         */
-        name: string;
-        /**
-         * Free-form metadata attached to the entity (shape is up to you).
-         */
-        metadata?: {
-            [key: string]: unknown;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        intents: Array<string>;
+        published: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        draft?: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
         };
-        /**
-         * ISO timestamp when the entity was created.
-         */
         createdAt: string;
-        /**
-         * ISO timestamp of the last update.
-         */
         updatedAt: string;
     };
 };
-export type Get2Response = Get2Responses[keyof Get2Responses];
-export type UpdateData = {
+export type Publish2Response = Publish2Responses[keyof Publish2Responses];
+export type Rollback2Data = {
     body?: {
         /**
-         * New name for the entity.
-         */
-        name?: string;
-        /**
-         * Replace the free-form metadata attached to the entity.
+         * Archived version number to restore as the new published.
          */
-        metadata?: {
-            [key: string]: unknown;
-        };
+        targetVersion: number;
     };
     path: {
+        /**
+         * KB article ID (format: `kb_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
-    url: '/entities/{id}';
+    url: '/kb/{id}/rollback';
 };
-export type UpdateErrors = {
+export type Rollback2Errors = {
     /**
      * Bad request
      */
@@ -925,52 +2445,64 @@ export type UpdateErrors = {
         };
     };
 };
-export type UpdateError = UpdateErrors[keyof UpdateErrors];
-export type UpdateResponses = {
+export type Rollback2Error = Rollback2Errors[keyof Rollback2Errors];
+export type Rollback2Responses = {
     /**
      * Successful response
      */
     200: {
         /**
-         * Entity ID (format: ent_xxxxxxxxxxxx).
+         * KB article ID (format: kb_xxxxxxxxxxxx).
          */
         id: string;
-        organizationId?: string | null;
-        /**
-         * Human-readable name of the entity.
-         */
-        name: string;
-        /**
-         * Free-form metadata attached to the entity (shape is up to you).
-         */
-        metadata?: {
-            [key: string]: unknown;
+        scope: {
+            level: 'global' | 'organization' | 'entity';
+            organizationId?: string;
+            entityId?: string;
+        };
+        intents: Array<string>;
+        published: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
+        };
+        draft?: {
+            version: number;
+            title: string;
+            content: string;
+            publishedAt?: string;
+            updatedAt?: string;
         };
-        /**
-         * ISO timestamp when the entity was created.
-         */
         createdAt: string;
-        /**
-         * ISO timestamp of the last update.
-         */
         updatedAt: string;
     };
 };
-export type UpdateResponse = UpdateResponses[keyof UpdateResponses];
-export type List3Data = {
+export type Rollback2Response = Rollback2Responses[keyof Rollback2Responses];
+export type List5Data = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Max number of items to return per page (1-100).
+         */
+        limit?: number;
+        /**
+         * Number of items to skip for pagination.
+         */
+        offset?: number | null;
+    };
     url: '/organizations';
 };
-export type List3Errors = {
+export type List5Errors = {
     /**
      * Bad request
      */
     400: {
         statusCode: number;
         error: {
-            code: 'MISSING-ORG';
+            code: 'MISSING-ORG' | 'VALIDATION' | 'INVALID-JSON';
             message: string;
         };
     };
@@ -995,15 +2527,12 @@ export type List3Errors = {
         };
     };
 };
-export type List3Error = List3Errors[keyof List3Errors];
-export type List3Responses = {
+export type List5Error = List5Errors[keyof List5Errors];
+export type List5Responses = {
     /**
      * Successful response
      */
     200: {
-        /**
-         * Organizations matching the query.
-         */
         organizations: Array<{
             /**
              * Organization ID (format: org_xxxxxxxxxxxx).
@@ -1013,12 +2542,6 @@ export type List3Responses = {
              * Human-readable name of the organization.
              */
             name: string;
-            /**
-             * Free-form metadata attached to the organization (shape is up to you).
-             */
-            metadata?: {
-                [key: string]: unknown;
-            };
             /**
              * ISO timestamp when the organization was created.
              */
@@ -1029,13 +2552,21 @@ export type List3Responses = {
             updatedAt: string;
         }>;
         /**
-         * Total number of organizations matching the query.
+         * Total number of items matching the query.
          */
         total: number;
+        /**
+         * Page size applied to this response.
+         */
+        limit: number;
+        /**
+         * Offset applied to this response.
+         */
+        offset: number;
     };
 };
-export type List3Response = List3Responses[keyof List3Responses];
-export type Create2Data = {
+export type List5Response = List5Responses[keyof List5Responses];
+export type Create4Data = {
     body?: {
         /**
          * Human-readable name of the organization (must be unique).
@@ -1056,7 +2587,7 @@ export type Create2Data = {
     query?: never;
     url: '/organizations';
 };
-export type Create2Errors = {
+export type Create4Errors = {
     /**
      * Bad request
      */
@@ -1088,8 +2619,8 @@ export type Create2Errors = {
         };
     };
 };
-export type Create2Error = Create2Errors[keyof Create2Errors];
-export type Create2Responses = {
+export type Create4Error = Create4Errors[keyof Create4Errors];
+export type Create4Responses = {
     /**
      * Successful response
      */
@@ -1106,12 +2637,6 @@ export type Create2Responses = {
              * Human-readable name of the organization.
              */
             name: string;
-            /**
-             * Free-form metadata attached to the organization (shape is up to you).
-             */
-            metadata?: {
-                [key: string]: unknown;
-            };
             /**
              * ISO timestamp when the organization was created.
              */
@@ -1120,6 +2645,12 @@ export type Create2Responses = {
              * ISO timestamp of the last update.
              */
             updatedAt: string;
+            /**
+             * Free-form metadata attached to the organization (shape is up to you).
+             */
+            metadata?: {
+                [key: string]: unknown;
+            };
         };
         /**
          * Scoped API key for the newly-created organization — shown only once. Store it securely; it cannot be retrieved later. Present only when `generateApiKey: true` was passed in the request.
@@ -1127,16 +2658,19 @@ export type Create2Responses = {
         apiKey?: string;
     };
 };
-export type Create2Response = Create2Responses[keyof Create2Responses];
-export type Delete2Data = {
+export type Create4Response = Create4Responses[keyof Create4Responses];
+export type Delete4Data = {
     body?: never;
     path: {
+        /**
+         * Organization ID (format: `org_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
     url: '/organizations/{id}';
 };
-export type Delete2Errors = {
+export type Delete4Errors = {
     /**
      * Bad request
      */
@@ -1168,8 +2702,8 @@ export type Delete2Errors = {
         };
     };
 };
-export type Delete2Error = Delete2Errors[keyof Delete2Errors];
-export type Delete2Responses = {
+export type Delete4Error = Delete4Errors[keyof Delete4Errors];
+export type Delete4Responses = {
     /**
      * Successful response
      */
@@ -1180,16 +2714,19 @@ export type Delete2Responses = {
         message: string;
     };
 };
-export type Delete2Response = Delete2Responses[keyof Delete2Responses];
-export type Get3Data = {
+export type Delete4Response = Delete4Responses[keyof Delete4Responses];
+export type Get5Data = {
     body?: never;
     path: {
+        /**
+         * Organization ID (format: `org_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
     url: '/organizations/{id}';
 };
-export type Get3Errors = {
+export type Get5Errors = {
     /**
      * Bad request
      */
@@ -1221,8 +2758,8 @@ export type Get3Errors = {
         };
     };
 };
-export type Get3Error = Get3Errors[keyof Get3Errors];
-export type Get3Responses = {
+export type Get5Error = Get5Errors[keyof Get5Errors];
+export type Get5Responses = {
     /**
      * Successful response
      */
@@ -1235,12 +2772,6 @@ export type Get3Responses = {
          * Human-readable name of the organization.
          */
         name: string;
-        /**
-         * Free-form metadata attached to the organization (shape is up to you).
-         */
-        metadata?: {
-            [key: string]: unknown;
-        };
         /**
          * ISO timestamp when the organization was created.
          */
@@ -1249,10 +2780,16 @@ export type Get3Responses = {
          * ISO timestamp of the last update.
          */
         updatedAt: string;
+        /**
+         * Free-form metadata attached to the organization (shape is up to you).
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
     };
 };
-export type Get3Response = Get3Responses[keyof Get3Responses];
-export type Update2Data = {
+export type Get5Response = Get5Responses[keyof Get5Responses];
+export type Update4Data = {
     body?: {
         /**
          * New name for the organization.
@@ -1266,12 +2803,15 @@ export type Update2Data = {
         };
     };
     path: {
+        /**
+         * Organization ID (format: `org_xxxxxxxxxxxx`).
+         */
         id: string;
     };
     query?: never;
     url: '/organizations/{id}';
 };
-export type Update2Errors = {
+export type Update4Errors = {
     /**
      * Bad request
      */
@@ -1303,8 +2843,8 @@ export type Update2Errors = {
         };
     };
 };
-export type Update2Error = Update2Errors[keyof Update2Errors];
-export type Update2Responses = {
+export type Update4Error = Update4Errors[keyof Update4Errors];
+export type Update4Responses = {
     /**
      * Successful response
      */
@@ -1317,12 +2857,6 @@ export type Update2Responses = {
          * Human-readable name of the organization.
          */
         name: string;
-        /**
-         * Free-form metadata attached to the organization (shape is up to you).
-         */
-        metadata?: {
-            [key: string]: unknown;
-        };
         /**
          * ISO timestamp when the organization was created.
          */
@@ -1331,7 +2865,13 @@ export type Update2Responses = {
          * ISO timestamp of the last update.
          */
         updatedAt: string;
+        /**
+         * Free-form metadata attached to the organization (shape is up to you).
+         */
+        metadata?: {
+            [key: string]: unknown;
+        };
     };
 };
-export type Update2Response = Update2Responses[keyof Update2Responses];
+export type Update4Response = Update4Responses[keyof Update4Responses];
 //# sourceMappingURL=types.gen.d.ts.map