@vellumai/assistant 0.8.7 → 0.8.8

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.8.7
+  version: 0.8.8
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -1057,119 +1057,6 @@ paths:
               required:
                 - uuid
               additionalProperties: false
-  /v1/apps/gallery:
-    get:
-      operationId: apps_gallery_get
-      summary: List gallery apps
-      description: Return the built-in app gallery catalog.
-      tags:
-        - apps
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  gallery:
-                    type: object
-                    properties:
-                      version:
-                        type: number
-                      updatedAt:
-                        type: string
-                      categories:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            id:
-                              type: string
-                            name:
-                              type: string
-                            icon:
-                              type: string
-                          required:
-                            - id
-                            - name
-                            - icon
-                          additionalProperties: false
-                      apps:
-                        type: array
-                        items:
-                          type: object
-                          properties:
-                            id:
-                              type: string
-                            name:
-                              type: string
-                            description:
-                              type: string
-                            icon:
-                              type: string
-                            category:
-                              type: string
-                            version:
-                              type: string
-                            featured:
-                              type: boolean
-                          required:
-                            - id
-                            - name
-                            - description
-                            - icon
-                            - category
-                            - version
-                          additionalProperties: false
-                    required:
-                      - version
-                      - updatedAt
-                      - categories
-                      - apps
-                    additionalProperties: false
-                required:
-                  - gallery
-                additionalProperties: false
-  /v1/apps/gallery/install:
-    post:
-      operationId: apps_gallery_install_post
-      summary: Install a gallery app
-      description: Install an app from the built-in gallery by its ID.
-      tags:
-        - apps
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success:
-                    type: boolean
-                    const: true
-                  appId:
-                    type: string
-                  name:
-                    type: string
-                required:
-                  - success
-                  - appId
-                  - name
-                additionalProperties: false
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                galleryAppId:
-                  type: string
-              required:
-                - galleryAppId
-              additionalProperties: false
   /v1/apps/import-bundle:
     post:
       operationId: apps_importbundle_post
@@ -1230,6 +1117,13 @@ paths:
                   - scanResult
                   - signatureResult
                 additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
   /v1/apps/open-bundle:
     post:
       operationId: apps_openbundle_post
@@ -1420,6 +1314,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/zip:
+              schema:
+                type: string
+                format: binary
       parameters:
         - name: token
           in: path
@@ -1585,29 +1484,22 @@ paths:
       requestBody:
         required: true
         content:
-          application/json:
+          multipart/form-data:
             schema:
               type: object
               properties:
+                file:
+                  type: string
+                  format: binary
+                  description: The file to upload
                 filename:
                   type: string
                 mimeType:
                   type: string
-                data:
-                  type: string
-                  description: Base64-encoded file data
-                filePath:
-                  type: string
-                  description: On-disk file path (file-backed upload)
-                trustedSource:
-                  type: boolean
-                  description:
-                    Set by the gateway when the file came from a guardian-bound channel actor. Honored only when the request is
-                    authenticated as a gateway service token; ignored otherwise.
               required:
+                - file
                 - filename
                 - mimeType
-              additionalProperties: false
   /v1/attachments/{id}:
     get:
       operationId: attachments_by_id_get
@@ -1664,6 +1556,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
         "416":
           description: Range Not Satisfiable
       parameters:
@@ -1868,6 +1765,140 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  bodyShapes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        viewBox:
+                          type: object
+                          properties:
+                            width:
+                              type: number
+                            height:
+                              type: number
+                          required:
+                            - width
+                            - height
+                          additionalProperties: false
+                        faceCenter:
+                          type: object
+                          properties:
+                            x:
+                              type: number
+                            y:
+                              type: number
+                          required:
+                            - x
+                            - y
+                          additionalProperties: false
+                        svgPath:
+                          type: string
+                      required:
+                        - id
+                        - viewBox
+                        - faceCenter
+                        - svgPath
+                      additionalProperties: false
+                  eyeStyles:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        sourceViewBox:
+                          type: object
+                          properties:
+                            width:
+                              type: number
+                            height:
+                              type: number
+                          required:
+                            - width
+                            - height
+                          additionalProperties: false
+                        eyeCenter:
+                          type: object
+                          properties:
+                            x:
+                              type: number
+                            y:
+                              type: number
+                          required:
+                            - x
+                            - y
+                          additionalProperties: false
+                        paths:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              svgPath:
+                                type: string
+                              color:
+                                type: string
+                            required:
+                              - svgPath
+                              - color
+                            additionalProperties: false
+                      required:
+                        - id
+                        - sourceViewBox
+                        - eyeCenter
+                        - paths
+                      additionalProperties: false
+                  colors:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        hex:
+                          type: string
+                      required:
+                        - id
+                        - hex
+                      additionalProperties: false
+                  faceCenterOverrides:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        bodyShape:
+                          type: string
+                        eyeStyle:
+                          type: string
+                        faceCenter:
+                          type: object
+                          properties:
+                            x:
+                              type: number
+                            y:
+                              type: number
+                          required:
+                            - x
+                            - y
+                          additionalProperties: false
+                      required:
+                        - bodyShape
+                        - eyeStyle
+                        - faceCenter
+                      additionalProperties: false
+                required:
+                  - bodyShapes
+                  - eyeStyles
+                  - colors
+                  - faceCenterOverrides
+                additionalProperties: false
   /v1/avatar/character/ascii:
     get:
       operationId: avatar_character_ascii_get
@@ -4168,6 +4199,25 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              propertyNames:
+                type: string
+              additionalProperties: {}
   /v1/config/allowlist/validate:
     get:
       operationId: config_allowlist_validate_get
@@ -4471,6 +4521,55 @@ paths:
                   - lastRunAt
                   - success
                 additionalProperties: false
+    put:
+      operationId: consolidation_config_put
+      summary: Update consolidation config
+      description: Update the memory v2 consolidation schedule configuration.
+      tags:
+        - consolidation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  available:
+                    type: boolean
+                  enabled:
+                    type: boolean
+                  intervalMs:
+                    type: number
+                  nextRunAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  lastRunAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  success:
+                    type: boolean
+                required:
+                  - available
+                  - enabled
+                  - intervalMs
+                  - nextRunAt
+                  - lastRunAt
+                  - success
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                enabled:
+                  description: Enable or disable automatic consolidation
+                  type: boolean
+              additionalProperties: false
   /v1/consolidation/run-now:
     post:
       operationId: consolidation_runnow_post
@@ -4566,10 +4665,18 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
-                        createdAt:
-                          type: number
-                      required:
-                        - id
+                        conversationExists:
+                          type: boolean
+                        conversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        estimatedCostUsd:
+                          type: number
+                        createdAt:
+                          type: number
+                      required:
+                        - id
                         - scheduledFor
                         - startedAt
                         - finishedAt
@@ -4578,6 +4685,9 @@ paths:
                         - skipReason
                         - error
                         - conversationId
+                        - conversationExists
+                        - conversationArchivedAt
+                        - estimatedCostUsd
                         - createdAt
                       additionalProperties: false
                     description: Consolidation run records
@@ -8214,6 +8324,17 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                    const: true
+                required:
+                  - ok
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -10004,6 +10125,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/pdf:
+              schema:
+                type: string
+                format: binary
       parameters:
         - name: id
           in: path
@@ -10019,6 +10145,47 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  subdomain:
+                    type: string
+                  domain:
+                    type: string
+                  created_at:
+                    type: string
+                  created:
+                    type: string
+                  email_error:
+                    type: object
+                    properties:
+                      detail:
+                        type: string
+                      code:
+                        type: string
+                    required:
+                      - detail
+                      - code
+                    additionalProperties: false
+                required:
+                  - id
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                subdomain:
+                  type: string
+                email_username:
+                  type: string
+              additionalProperties: false
   /v1/domain/status:
     get:
       operationId: domain_status_get
@@ -10028,6 +10195,43 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  count:
+                    type: number
+                  next:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  previous:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        subdomain:
+                          type: string
+                        domain:
+                          type: string
+                        created_at:
+                          type: string
+                        created:
+                          type: string
+                      required:
+                        - id
+                      additionalProperties: false
+                required:
+                  - count
+                  - results
+                additionalProperties: false
   /v1/domain/verification-status:
     post:
       operationId: domain_verificationstatus_post
@@ -10037,6 +10241,34 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  domain:
+                    type: string
+                  status:
+                    type: string
+                  message:
+                    type: string
+                required:
+                  - domain
+                  - status
+                  - message
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                domain_id:
+                  type: string
+              required:
+                - domain_id
+              additionalProperties: false
   /v1/email/attachment-get:
     get:
       operationId: email_attachmentget_get
@@ -10378,11 +10610,12 @@ paths:
           schema:
             type: string
           description:
-            "Optional reconnect cursor: the highest per-conversation event seq the client has already applied. When set
-            together with a conversation scope, the daemon replays any buffered events with seq > lastSeenSeq before
-            going live. If the cursor is older than the ring buffer's oldest entry the connection simply goes live; the
-            client is expected to detect the gap from the next event's seq and refetch via the messages API. Must be a
-            non-negative integer."
+            "Optional reconnect cursor: the highest global event seq the client has already applied. `seq` is a single
+            per-assistant counter shared across all conversations, so one cursor resumes the stream regardless of how
+            many conversations are multiplexed on the connection. When set, the daemon replays any buffered events with
+            seq > lastSeenSeq (re-applying the subscriber's targeting/scope filter) before going live. If the cursor is
+            older than the ring buffer's oldest entry the connection simply goes live; the client is expected to detect
+            the gap from the next event's seq and refetch via the messages API. Must be a non-negative integer."
   /v1/events/emit:
     post:
       operationId: events_emit_post
@@ -10419,6 +10652,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/gzip:
+              schema:
+                type: string
+                format: binary
         "500":
           description: Failed to create archive
       requestBody:
@@ -10529,6 +10767,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  lines:
+                    type: array
+                    items:
+                      type: object
+                      propertyNames:
+                        type: string
+                      additionalProperties: {}
+                  truncated:
+                    type: boolean
+                required:
+                  - lines
+                  - truncated
+                additionalProperties: false
       parameters:
         - name: n
           in: query
@@ -10847,21 +11103,59 @@ paths:
                   version:
                     type: string
                   disk:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
+                    anyOf:
+                      - type: object
+                        properties:
+                          path:
+                            type: string
+                          totalMb:
+                            type: number
+                          usedMb:
+                            type: number
+                          freeMb:
+                            type: number
+                        required:
+                          - path
+                          - totalMb
+                          - usedMb
+                          - freeMb
+                        additionalProperties: false
+                      - type: "null"
                   memory:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      currentMb:
+                        type: number
+                      maxMb:
+                        type: number
+                    required:
+                      - currentMb
+                      - maxMb
+                    additionalProperties: false
                   cpu:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      currentPercent:
+                        type: number
+                      maxCores:
+                        type: number
+                    required:
+                      - currentPercent
+                      - maxCores
+                    additionalProperties: false
                   migrations:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      dbVersion:
+                        type: number
+                      lastWorkspaceMigrationId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                    required:
+                      - dbVersion
+                      - lastWorkspaceMigrationId
+                    additionalProperties: false
                   ces:
                     type: object
                     properties:
@@ -10977,21 +11271,59 @@ paths:
                   version:
                     type: string
                   disk:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
+                    anyOf:
+                      - type: object
+                        properties:
+                          path:
+                            type: string
+                          totalMb:
+                            type: number
+                          usedMb:
+                            type: number
+                          freeMb:
+                            type: number
+                        required:
+                          - path
+                          - totalMb
+                          - usedMb
+                          - freeMb
+                        additionalProperties: false
+                      - type: "null"
                   memory:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      currentMb:
+                        type: number
+                      maxMb:
+                        type: number
+                    required:
+                      - currentMb
+                      - maxMb
+                    additionalProperties: false
                   cpu:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      currentPercent:
+                        type: number
+                      maxCores:
+                        type: number
+                    required:
+                      - currentPercent
+                      - maxCores
+                    additionalProperties: false
                   migrations:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
+                    properties:
+                      dbVersion:
+                        type: number
+                      lastWorkspaceMigrationId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                    required:
+                      - dbVersion
+                      - lastWorkspaceMigrationId
+                    additionalProperties: false
                   ces:
                     type: object
                     properties:
@@ -11361,6 +11693,14 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        conversationExists:
+                          type: boolean
+                        conversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        estimatedCostUsd:
+                          type: number
                         createdAt:
                           type: number
                       required:
@@ -11373,6 +11713,9 @@ paths:
                         - skipReason
                         - error
                         - conversationId
+                        - conversationExists
+                        - conversationArchivedAt
+                        - estimatedCostUsd
                         - createdAt
                       additionalProperties: false
                     description: Heartbeat run records
@@ -12499,7 +12842,9 @@ paths:
     get:
       operationId: identity_intro_get
       summary: Get identity greetings
-      description: Returns an array of greetings sourced from SOUL.md, LLM cache, or static fallbacks.
+      description:
+        Returns greetings sourced from SOUL.md, the generated cache, or generic fallbacks while background
+        generation refreshes the cache.
       tags:
         - identity
       responses:
@@ -12516,9 +12861,19 @@ paths:
                       type: string
                   text:
                     type: string
+                  source:
+                    type: string
+                    enum:
+                      - workspace
+                      - cache
+                      - fallback
+                  refreshing:
+                    type: boolean
                 required:
                   - greetings
                   - text
+                  - source
+                  - refreshing
                 additionalProperties: false
   /v1/image-generation/generate:
     post:
@@ -12530,45 +12885,107 @@ paths:
       responses:
         "200":
           description: Successful response
-  /v1/inference/chatgpt-subscription/auth:
-    post:
-      operationId: inference_chatgptsubscription_auth_post
-      summary: Start ChatGPT subscription OAuth PKCE flow
-      description:
-        Generate a PKCE authorize URL for ChatGPT subscription auth. Returns the URL and state for the client to
-        open in a browser.
-      tags:
-        - inference
-      responses:
-        "200":
-          description: Successful response
           content:
             application/json:
               schema:
                 type: object
                 properties:
-                  authorize_url:
+                  images:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        mimeType:
+                          type: string
+                        dataBase64:
+                          type: string
+                        title:
+                          type: string
+                      required:
+                        - mimeType
+                        - dataBase64
+                      additionalProperties: false
+                  text:
                     type: string
-                  state:
+                  resolvedModel:
                     type: string
                 required:
-                  - authorize_url
-                  - state
+                  - images
+                  - resolvedModel
                 additionalProperties: false
-  /v1/inference/chatgpt-subscription/auth/exchange:
-    post:
-      operationId: inference_chatgptsubscription_auth_exchange_post
-      summary: Exchange ChatGPT subscription OAuth authorization code
-      description:
-        Accept an authorization code and state from the OAuth redirect, exchange it for tokens, store them in CES,
-        and upsert the provider connection.
-      tags:
-        - inference
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                prompt:
+                  type: string
+                mode:
+                  type: string
+                  enum:
+                    - generate
+                    - edit
+                sourceImages:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      mimeType:
+                        type: string
+                      dataBase64:
+                        type: string
+                    required:
+                      - mimeType
+                      - dataBase64
+                    additionalProperties: false
+                model:
+                  type: string
+                variants:
+                  type: number
+              required:
+                - prompt
+              additionalProperties: false
+  /v1/inference/chatgpt-subscription/auth:
+    post:
+      operationId: inference_chatgptsubscription_auth_post
+      summary: Start ChatGPT subscription OAuth PKCE flow
+      description:
+        Generate a PKCE authorize URL for ChatGPT subscription auth. Returns the URL and state for the client to
+        open in a browser.
+      tags:
+        - inference
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  authorize_url:
+                    type: string
+                  state:
+                    type: string
+                required:
+                  - authorize_url
+                  - state
+                additionalProperties: false
+  /v1/inference/chatgpt-subscription/auth/exchange:
+    post:
+      operationId: inference_chatgptsubscription_auth_exchange_post
+      summary: Exchange ChatGPT subscription OAuth authorization code
+      description:
+        Accept an authorization code and state from the OAuth redirect, exchange it for tokens, store them in CES,
+        and upsert the provider connection.
+      tags:
+        - inference
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
               schema:
                 type: object
                 properties:
@@ -13450,6 +13867,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  enabled:
+                    type: boolean
+                  activeConnections:
+                    type: number
+                  error:
+                    type: string
+                required:
+                  - success
+                  - enabled
+                  - activeConnections
+                additionalProperties: false
     get:
       operationId: integrations_a2a_config_get
       summary: Get A2A config
@@ -13459,6 +13894,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  enabled:
+                    type: boolean
+                  activeConnections:
+                    type: number
+                  error:
+                    type: string
+                required:
+                  - success
+                  - enabled
+                  - activeConnections
+                additionalProperties: false
     post:
       operationId: integrations_a2a_config_post
       summary: Enable A2A channel
@@ -13468,6 +13921,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  enabled:
+                    type: boolean
+                  activeConnections:
+                    type: number
+                  error:
+                    type: string
+                required:
+                  - success
+                  - enabled
+                  - activeConnections
+                additionalProperties: false
   /v1/integrations/a2a/invite:
     post:
       operationId: integrations_a2a_invite_post
@@ -13510,6 +13981,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  contactId:
+                    type: string
+                  alreadyConnected:
+                    type: boolean
+                  error:
+                    type: string
+                  errorCode:
+                    type: string
+                required:
+                  - success
+                additionalProperties: false
   /v1/integrations/a2a/invite/complete:
     post:
       operationId: integrations_a2a_invite_complete_post
@@ -13520,6 +14009,32 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  sender:
+                    type: object
+                    properties:
+                      assistantId:
+                        type: string
+                      displayName:
+                        type: string
+                      gatewayUrl:
+                        type: string
+                    required:
+                      - assistantId
+                      - displayName
+                      - gatewayUrl
+                    additionalProperties: false
+                  error:
+                    type: string
+                required:
+                  - success
+                additionalProperties: false
   /v1/integrations/a2a/invite/redeem:
     post:
       operationId: integrations_a2a_invite_redeem_post
@@ -13530,6 +14045,22 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  contactId:
+                    type: string
+                  alreadyConnected:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - success
+                additionalProperties: false
   /v1/integrations/ingress/config:
     get:
       operationId: integrations_ingress_config_get
@@ -13621,6 +14152,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  hasAppToken:
+                    type: boolean
+                  hasUserToken:
+                    type: boolean
+                  connected:
+                    type: boolean
+                  teamId:
+                    type: string
+                  teamName:
+                    type: string
+                  teamUrl:
+                    type: string
+                  botUserId:
+                    type: string
+                  botUsername:
+                    type: string
+                  error:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - hasAppToken
+                  - hasUserToken
+                  - connected
+                additionalProperties: false
     get:
       operationId: integrations_slack_channel_config_get
       summary: Get Slack channel config
@@ -13630,6 +14197,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  hasAppToken:
+                    type: boolean
+                  hasUserToken:
+                    type: boolean
+                  connected:
+                    type: boolean
+                  teamId:
+                    type: string
+                  teamName:
+                    type: string
+                  teamUrl:
+                    type: string
+                  botUserId:
+                    type: string
+                  botUsername:
+                    type: string
+                  error:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - hasAppToken
+                  - hasUserToken
+                  - connected
+                additionalProperties: false
     post:
       operationId: integrations_slack_channel_config_post
       summary: Set Slack channel config
@@ -13639,6 +14242,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  hasAppToken:
+                    type: boolean
+                  hasUserToken:
+                    type: boolean
+                  connected:
+                    type: boolean
+                  teamId:
+                    type: string
+                  teamName:
+                    type: string
+                  teamUrl:
+                    type: string
+                  botUserId:
+                    type: string
+                  botUsername:
+                    type: string
+                  error:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - hasAppToken
+                  - hasUserToken
+                  - connected
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -13666,6 +14305,39 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  botId:
+                    type: string
+                  botUsername:
+                    type: string
+                  connected:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  lastError:
+                    type: string
+                  error:
+                    type: string
+                  commandsRegistered:
+                    type: array
+                    items:
+                      type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - connected
+                  - hasWebhookSecret
+                additionalProperties: false
   /v1/integrations/telegram/config:
     delete:
       operationId: integrations_telegram_config_delete
@@ -13676,15 +14348,81 @@ paths:
       responses:
         "200":
           description: Successful response
-    get:
-      operationId: integrations_telegram_config_get
-      summary: Get Telegram config
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  botId:
+                    type: string
+                  botUsername:
+                    type: string
+                  connected:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  lastError:
+                    type: string
+                  error:
+                    type: string
+                  commandsRegistered:
+                    type: array
+                    items:
+                      type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - connected
+                  - hasWebhookSecret
+                additionalProperties: false
+    get:
+      operationId: integrations_telegram_config_get
+      summary: Get Telegram config
       description: Check current Telegram bot configuration status.
       tags:
         - integrations
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  botId:
+                    type: string
+                  botUsername:
+                    type: string
+                  connected:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  lastError:
+                    type: string
+                  error:
+                    type: string
+                  commandsRegistered:
+                    type: array
+                    items:
+                      type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - connected
+                  - hasWebhookSecret
+                additionalProperties: false
     post:
       operationId: integrations_telegram_config_post
       summary: Set Telegram config
@@ -13694,6 +14432,39 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  botId:
+                    type: string
+                  botUsername:
+                    type: string
+                  connected:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  lastError:
+                    type: string
+                  error:
+                    type: string
+                  commandsRegistered:
+                    type: array
+                    items:
+                      type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - connected
+                  - hasWebhookSecret
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -13717,6 +14488,39 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasBotToken:
+                    type: boolean
+                  botId:
+                    type: string
+                  botUsername:
+                    type: string
+                  connected:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  lastError:
+                    type: string
+                  error:
+                    type: string
+                  commandsRegistered:
+                    type: array
+                    items:
+                      type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasBotToken
+                  - connected
+                  - hasWebhookSecret
+                additionalProperties: false
   /v1/integrations/twilio/config:
     get:
       operationId: integrations_twilio_config_get
@@ -13727,6 +14531,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                  accountSid:
+                    type: string
+                  phoneNumber:
+                    type: string
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
   /v1/integrations/twilio/credentials:
     delete:
       operationId: integrations_twilio_credentials_delete
@@ -13737,6 +14558,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
     post:
       operationId: integrations_twilio_credentials_post
       summary: Set Twilio credentials
@@ -13746,6 +14580,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -13773,6 +14620,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                  numbers:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        phoneNumber:
+                          type: string
+                        friendlyName:
+                          type: string
+                        capabilities:
+                          type: object
+                          properties:
+                            voice:
+                              type: boolean
+                          required:
+                            - voice
+                          additionalProperties: false
+                      required:
+                        - phoneNumber
+                        - friendlyName
+                        - capabilities
+                      additionalProperties: false
+                required:
+                  - success
+                  - hasCredentials
+                  - numbers
+                additionalProperties: false
   /v1/integrations/twilio/numbers/assign:
     post:
       operationId: integrations_twilio_numbers_assign_post
@@ -13783,6 +14666,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                  phoneNumber:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
   /v1/integrations/twilio/numbers/provision:
     post:
       operationId: integrations_twilio_numbers_provision_post
@@ -13793,6 +14693,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                  phoneNumber:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
   /v1/integrations/twilio/numbers/release:
     post:
       operationId: integrations_twilio_numbers_release_post
@@ -13803,6 +14720,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  hasCredentials:
+                    type: boolean
+                  phoneNumber:
+                    type: string
+                  warning:
+                    type: string
+                required:
+                  - success
+                  - hasCredentials
+                additionalProperties: false
   /v1/integrations/vercel/config:
     delete:
       operationId: integrations_vercel_config_delete
@@ -14093,6 +15027,86 @@ paths:
           required: true
           schema:
             type: string
+  /v1/internal/telemetry/auth-fallback:
+    post:
+      operationId: internal_telemetry_authfallback_post
+      summary: Record auth-fallback counts
+      description:
+        Receives aggregated legacy-loopback auth-fallback counts forwarded by the gateway and persists them for
+        telemetry reporting.
+      tags:
+        - internal
+        - telemetry
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                anyOf:
+                  - type: object
+                    properties:
+                      recorded:
+                        type: integer
+                        minimum: 0
+                        maximum: 9007199254740991
+                    required:
+                      - recorded
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      skipped:
+                        type: boolean
+                        const: true
+                        description: Counts dropped because usage data collection is disabled
+                    required:
+                      - skipped
+                    additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                window_start:
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
+                window_end:
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
+                counts:
+                  minItems: 1
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      guard:
+                        type: string
+                        minLength: 1
+                      path:
+                        type: string
+                        minLength: 1
+                      failure_kind:
+                        type: string
+                        minLength: 1
+                      count:
+                        type: integer
+                        exclusiveMinimum: 0
+                        maximum: 9007199254740991
+                    required:
+                      - guard
+                      - path
+                      - failure_kind
+                      - count
+                    additionalProperties: false
+              required:
+                - window_start
+                - window_end
+                - counts
+              additionalProperties: false
   /v1/internal/twilio/connect-action:
     post:
       operationId: internal_twilio_connectaction_post
@@ -14163,6 +15177,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/gzip:
+              schema:
+                type: string
+                format: binary
         "500":
           description: Failed to create archive
       requestBody:
@@ -14559,7 +15578,34 @@ paths:
       responses:
         "200":
           description: Successful response
-      requestBody:
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  pages:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        slug:
+                          type: string
+                        bodyBytes:
+                          type: number
+                        edgeCount:
+                          type: number
+                        updatedAtMs:
+                          type: number
+                      required:
+                        - slug
+                        - bodyBytes
+                        - edgeCount
+                        - updatedAtMs
+                      additionalProperties: false
+                required:
+                  - pages
+                additionalProperties: false
+      requestBody:
         required: true
         content:
           application/json:
@@ -14810,6 +15856,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  rendered:
+                    type: string
+                  counts:
+                    type: object
+                    properties:
+                      unassigned:
+                        type: number
+                      danglingRefs:
+                        type: number
+                      novelClusters:
+                        type: number
+                      oversizedLeaves:
+                        type: number
+                      tinyLeaves:
+                        type: number
+                    required:
+                      - unassigned
+                      - danglingRefs
+                      - novelClusters
+                      - oversizedLeaves
+                      - tinyLeaves
+                    additionalProperties: false
+                required:
+                  - rendered
+                  - counts
+                additionalProperties: false
   /v1/memory/v3/rebuild-index:
     post:
       operationId: memory_v3_rebuildindex_post
@@ -14819,6 +15896,17 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                    const: true
+                required:
+                  - ok
+                additionalProperties: false
   /v1/memory/v3/reconcile:
     post:
       operationId: memory_v3_reconcile_post
@@ -14828,6 +15916,39 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  renames:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        oldPath:
+                          type: string
+                        newPath:
+                          type: string
+                      required:
+                        - oldPath
+                        - newPath
+                      additionalProperties: false
+                  deleted:
+                    type: array
+                    items:
+                      type: string
+                  prunedCore:
+                    type: array
+                    items:
+                      type: string
+                required:
+                  - renames
+                  - deleted
+                  - prunedCore
+                additionalProperties: false
   /v1/memory/v3/set-core:
     post:
       operationId: memory_v3_setcore_post
@@ -14837,6 +15958,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  nextCore:
+                    type: array
+                    items:
+                      type: string
+                  alwaysOnPageCount:
+                    type: number
+                  written:
+                    type: boolean
+                required:
+                  - nextCore
+                  - alwaysOnPageCount
+                  - written
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                add:
+                  type: array
+                  items:
+                    type: string
+                remove:
+                  type: array
+                  items:
+                    type: string
+                write:
+                  type: boolean
+              additionalProperties: false
   /v1/messages:
     get:
       operationId: messages_get
@@ -14854,7 +16011,851 @@ paths:
                 properties:
                   messages:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        mergedMessageIds:
+                          type: array
+                          items:
+                            type: string
+                        role:
+                          type: string
+                        content:
+                          type: string
+                        timestamp:
+                          type: string
+                        attachments:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: string
+                              filename:
+                                type: string
+                              mimeType:
+                                type: string
+                              sizeBytes:
+                                type: number
+                              kind:
+                                type: string
+                              data:
+                                type: string
+                              thumbnailData:
+                                type: string
+                              fileBacked:
+                                type: boolean
+                            required:
+                              - id
+                              - filename
+                              - mimeType
+                              - sizeBytes
+                              - kind
+                            additionalProperties: false
+                        toolCalls:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: string
+                              name:
+                                type: string
+                              input:
+                                type: object
+                                propertyNames:
+                                  type: string
+                                additionalProperties: {}
+                              result:
+                                type: string
+                              isError:
+                                type: boolean
+                              imageData:
+                                type: string
+                              imageDataList:
+                                type: array
+                                items:
+                                  type: string
+                              startedAt:
+                                type: number
+                              completedAt:
+                                type: number
+                              confirmationDecision:
+                                type: string
+                                enum:
+                                  - approved
+                                  - denied
+                                  - timed_out
+                              confirmationLabel:
+                                type: string
+                              riskLevel:
+                                type: string
+                              riskReason:
+                                type: string
+                              matchedTrustRuleId:
+                                type: string
+                              autoApproved:
+                                type: boolean
+                              approvalMode:
+                                type: string
+                              approvalReason:
+                                type: string
+                              riskThreshold:
+                                type: string
+                              riskScopeOptions:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    pattern:
+                                      type: string
+                                    label:
+                                      type: string
+                                  required:
+                                    - pattern
+                                    - label
+                                  additionalProperties: false
+                              riskAllowlistOptions:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    label:
+                                      type: string
+                                    description:
+                                      type: string
+                                    pattern:
+                                      type: string
+                                  required:
+                                    - label
+                                    - description
+                                    - pattern
+                                  additionalProperties: false
+                              riskDirectoryScopeOptions:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    scope:
+                                      type: string
+                                    label:
+                                      type: string
+                                  required:
+                                    - scope
+                                    - label
+                                  additionalProperties: false
+                              activityMetadata:
+                                type: object
+                                properties:
+                                  webSearch:
+                                    type: object
+                                    properties:
+                                      query:
+                                        type: string
+                                      provider:
+                                        type: string
+                                        enum:
+                                          - anthropic-native
+                                          - brave
+                                          - perplexity
+                                          - tavily
+                                      resultCount:
+                                        type: number
+                                      durationMs:
+                                        type: number
+                                      results:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            rank:
+                                              type: number
+                                            title:
+                                              type: string
+                                            url:
+                                              type: string
+                                            domain:
+                                              type: string
+                                            faviconUrl:
+                                              type: string
+                                            snippet:
+                                              type: string
+                                            age:
+                                              type: string
+                                            score:
+                                              type: number
+                                          required:
+                                            - rank
+                                            - title
+                                            - url
+                                            - domain
+                                          additionalProperties: false
+                                      errorMessage:
+                                        type: string
+                                    required:
+                                      - query
+                                      - provider
+                                      - resultCount
+                                      - durationMs
+                                      - results
+                                    additionalProperties: false
+                                  webFetch:
+                                    type: object
+                                    properties:
+                                      url:
+                                        type: string
+                                      finalUrl:
+                                        type: string
+                                      status:
+                                        type: number
+                                      contentType:
+                                        type: string
+                                      byteCount:
+                                        type: number
+                                      charCount:
+                                        type: number
+                                      truncated:
+                                        type: boolean
+                                      title:
+                                        type: string
+                                      domain:
+                                        type: string
+                                      faviconUrl:
+                                        type: string
+                                      redirectCount:
+                                        type: number
+                                      durationMs:
+                                        type: number
+                                      errorMessage:
+                                        type: string
+                                      mayRequireJavaScript:
+                                        type: boolean
+                                    required:
+                                      - url
+                                      - finalUrl
+                                      - status
+                                      - byteCount
+                                      - charCount
+                                      - truncated
+                                      - domain
+                                      - redirectCount
+                                      - durationMs
+                                    additionalProperties: false
+                                additionalProperties: false
+                              scopeOptions:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    label:
+                                      type: string
+                                    scope:
+                                      type: string
+                                  required:
+                                    - label
+                                    - scope
+                                  additionalProperties: false
+                              pendingConfirmation:
+                                type: object
+                                properties:
+                                  requestId:
+                                    type: string
+                                  title:
+                                    type: string
+                                  description:
+                                    type: string
+                                  toolName:
+                                    type: string
+                                  riskLevel:
+                                    type: string
+                                  riskReason:
+                                    type: string
+                                  input:
+                                    type: object
+                                    propertyNames:
+                                      type: string
+                                    additionalProperties: {}
+                                  allowlistOptions:
+                                    type: array
+                                    items:
+                                      type: object
+                                      properties:
+                                        label:
+                                          type: string
+                                        description:
+                                          type: string
+                                        pattern:
+                                          type: string
+                                      required:
+                                        - label
+                                        - description
+                                        - pattern
+                                      additionalProperties: false
+                                  scopeOptions:
+                                    type: array
+                                    items:
+                                      type: object
+                                      properties:
+                                        label:
+                                          type: string
+                                        scope:
+                                          type: string
+                                      required:
+                                        - label
+                                        - scope
+                                      additionalProperties: false
+                                  directoryScopeOptions:
+                                    type: array
+                                    items:
+                                      type: object
+                                      properties:
+                                        label:
+                                          type: string
+                                        scope:
+                                          type: string
+                                      required:
+                                        - label
+                                        - scope
+                                      additionalProperties: false
+                                  persistentDecisionsAllowed:
+                                    type: boolean
+                                required:
+                                  - requestId
+                                additionalProperties: false
+                            required:
+                              - name
+                              - input
+                            additionalProperties: false
+                        surfaces:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              surfaceId:
+                                type: string
+                              surfaceType:
+                                type: string
+                              title:
+                                type: string
+                              data:
+                                type: object
+                                propertyNames:
+                                  type: string
+                                additionalProperties: {}
+                              actions:
+                                type: array
+                                items:
+                                  type: object
+                                  properties:
+                                    id:
+                                      type: string
+                                    label:
+                                      type: string
+                                    style:
+                                      type: string
+                                    data:
+                                      type: object
+                                      propertyNames:
+                                        type: string
+                                      additionalProperties: {}
+                                  required:
+                                    - id
+                                    - label
+                                  additionalProperties: false
+                              display:
+                                type: string
+                              persistent:
+                                type: boolean
+                              completed:
+                                type: boolean
+                              completionSummary:
+                                type: string
+                              toolCallId:
+                                type: string
+                            required:
+                              - surfaceId
+                              - surfaceType
+                              - data
+                            additionalProperties: false
+                        textSegments:
+                          type: array
+                          items:
+                            type: string
+                        thinkingSegments:
+                          type: array
+                          items:
+                            type: string
+                        contentOrder:
+                          type: array
+                          items:
+                            type: string
+                        contentBlocks:
+                          type: array
+                          items:
+                            oneOf:
+                              - type: object
+                                properties:
+                                  type:
+                                    type: string
+                                    const: text
+                                  text:
+                                    type: string
+                                required:
+                                  - type
+                                  - text
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  type:
+                                    type: string
+                                    const: thinking
+                                  thinking:
+                                    type: string
+                                required:
+                                  - type
+                                  - thinking
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  type:
+                                    type: string
+                                    const: tool_use
+                                  toolCall:
+                                    type: object
+                                    properties:
+                                      id:
+                                        type: string
+                                      name:
+                                        type: string
+                                      input:
+                                        type: object
+                                        propertyNames:
+                                          type: string
+                                        additionalProperties: {}
+                                      result:
+                                        type: string
+                                      isError:
+                                        type: boolean
+                                      imageData:
+                                        type: string
+                                      imageDataList:
+                                        type: array
+                                        items:
+                                          type: string
+                                      startedAt:
+                                        type: number
+                                      completedAt:
+                                        type: number
+                                      confirmationDecision:
+                                        type: string
+                                        enum:
+                                          - approved
+                                          - denied
+                                          - timed_out
+                                      confirmationLabel:
+                                        type: string
+                                      riskLevel:
+                                        type: string
+                                      riskReason:
+                                        type: string
+                                      matchedTrustRuleId:
+                                        type: string
+                                      autoApproved:
+                                        type: boolean
+                                      approvalMode:
+                                        type: string
+                                      approvalReason:
+                                        type: string
+                                      riskThreshold:
+                                        type: string
+                                      riskScopeOptions:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            pattern:
+                                              type: string
+                                            label:
+                                              type: string
+                                          required:
+                                            - pattern
+                                            - label
+                                          additionalProperties: false
+                                      riskAllowlistOptions:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            label:
+                                              type: string
+                                            description:
+                                              type: string
+                                            pattern:
+                                              type: string
+                                          required:
+                                            - label
+                                            - description
+                                            - pattern
+                                          additionalProperties: false
+                                      riskDirectoryScopeOptions:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            scope:
+                                              type: string
+                                            label:
+                                              type: string
+                                          required:
+                                            - scope
+                                            - label
+                                          additionalProperties: false
+                                      activityMetadata:
+                                        type: object
+                                        properties:
+                                          webSearch:
+                                            type: object
+                                            properties:
+                                              query:
+                                                type: string
+                                              provider:
+                                                type: string
+                                                enum:
+                                                  - anthropic-native
+                                                  - brave
+                                                  - perplexity
+                                                  - tavily
+                                              resultCount:
+                                                type: number
+                                              durationMs:
+                                                type: number
+                                              results:
+                                                type: array
+                                                items:
+                                                  type: object
+                                                  properties:
+                                                    rank:
+                                                      type: number
+                                                    title:
+                                                      type: string
+                                                    url:
+                                                      type: string
+                                                    domain:
+                                                      type: string
+                                                    faviconUrl:
+                                                      type: string
+                                                    snippet:
+                                                      type: string
+                                                    age:
+                                                      type: string
+                                                    score:
+                                                      type: number
+                                                  required:
+                                                    - rank
+                                                    - title
+                                                    - url
+                                                    - domain
+                                                  additionalProperties: false
+                                              errorMessage:
+                                                type: string
+                                            required:
+                                              - query
+                                              - provider
+                                              - resultCount
+                                              - durationMs
+                                              - results
+                                            additionalProperties: false
+                                          webFetch:
+                                            type: object
+                                            properties:
+                                              url:
+                                                type: string
+                                              finalUrl:
+                                                type: string
+                                              status:
+                                                type: number
+                                              contentType:
+                                                type: string
+                                              byteCount:
+                                                type: number
+                                              charCount:
+                                                type: number
+                                              truncated:
+                                                type: boolean
+                                              title:
+                                                type: string
+                                              domain:
+                                                type: string
+                                              faviconUrl:
+                                                type: string
+                                              redirectCount:
+                                                type: number
+                                              durationMs:
+                                                type: number
+                                              errorMessage:
+                                                type: string
+                                              mayRequireJavaScript:
+                                                type: boolean
+                                            required:
+                                              - url
+                                              - finalUrl
+                                              - status
+                                              - byteCount
+                                              - charCount
+                                              - truncated
+                                              - domain
+                                              - redirectCount
+                                              - durationMs
+                                            additionalProperties: false
+                                        additionalProperties: false
+                                      scopeOptions:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            label:
+                                              type: string
+                                            scope:
+                                              type: string
+                                          required:
+                                            - label
+                                            - scope
+                                          additionalProperties: false
+                                      pendingConfirmation:
+                                        type: object
+                                        properties:
+                                          requestId:
+                                            type: string
+                                          title:
+                                            type: string
+                                          description:
+                                            type: string
+                                          toolName:
+                                            type: string
+                                          riskLevel:
+                                            type: string
+                                          riskReason:
+                                            type: string
+                                          input:
+                                            type: object
+                                            propertyNames:
+                                              type: string
+                                            additionalProperties: {}
+                                          allowlistOptions:
+                                            type: array
+                                            items:
+                                              type: object
+                                              properties:
+                                                label:
+                                                  type: string
+                                                description:
+                                                  type: string
+                                                pattern:
+                                                  type: string
+                                              required:
+                                                - label
+                                                - description
+                                                - pattern
+                                              additionalProperties: false
+                                          scopeOptions:
+                                            type: array
+                                            items:
+                                              type: object
+                                              properties:
+                                                label:
+                                                  type: string
+                                                scope:
+                                                  type: string
+                                              required:
+                                                - label
+                                                - scope
+                                              additionalProperties: false
+                                          directoryScopeOptions:
+                                            type: array
+                                            items:
+                                              type: object
+                                              properties:
+                                                label:
+                                                  type: string
+                                                scope:
+                                                  type: string
+                                              required:
+                                                - label
+                                                - scope
+                                              additionalProperties: false
+                                          persistentDecisionsAllowed:
+                                            type: boolean
+                                        required:
+                                          - requestId
+                                        additionalProperties: false
+                                    required:
+                                      - name
+                                      - input
+                                    additionalProperties: false
+                                required:
+                                  - type
+                                  - toolCall
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  type:
+                                    type: string
+                                    const: surface
+                                  surface:
+                                    type: object
+                                    properties:
+                                      surfaceId:
+                                        type: string
+                                      surfaceType:
+                                        type: string
+                                      title:
+                                        type: string
+                                      data:
+                                        type: object
+                                        propertyNames:
+                                          type: string
+                                        additionalProperties: {}
+                                      actions:
+                                        type: array
+                                        items:
+                                          type: object
+                                          properties:
+                                            id:
+                                              type: string
+                                            label:
+                                              type: string
+                                            style:
+                                              type: string
+                                            data:
+                                              type: object
+                                              propertyNames:
+                                                type: string
+                                              additionalProperties: {}
+                                          required:
+                                            - id
+                                            - label
+                                          additionalProperties: false
+                                      display:
+                                        type: string
+                                      persistent:
+                                        type: boolean
+                                      completed:
+                                        type: boolean
+                                      completionSummary:
+                                        type: string
+                                      toolCallId:
+                                        type: string
+                                    required:
+                                      - surfaceId
+                                      - surfaceType
+                                      - data
+                                    additionalProperties: false
+                                required:
+                                  - type
+                                  - surface
+                                additionalProperties: false
+                              - type: object
+                                properties:
+                                  type:
+                                    type: string
+                                    const: attachment
+                                  attachment:
+                                    type: object
+                                    properties:
+                                      id:
+                                        type: string
+                                      filename:
+                                        type: string
+                                      mimeType:
+                                        type: string
+                                      sizeBytes:
+                                        type: number
+                                      kind:
+                                        type: string
+                                      data:
+                                        type: string
+                                      thumbnailData:
+                                        type: string
+                                      fileBacked:
+                                        type: boolean
+                                    required:
+                                      - id
+                                      - filename
+                                      - mimeType
+                                      - sizeBytes
+                                      - kind
+                                    additionalProperties: false
+                                required:
+                                  - type
+                                  - attachment
+                                additionalProperties: false
+                        subagentNotification:
+                          type: object
+                          properties:
+                            subagentId:
+                              type: string
+                            label:
+                              type: string
+                            status:
+                              type: string
+                            error:
+                              type: string
+                            conversationId:
+                              type: string
+                            objective:
+                              type: string
+                          required:
+                            - subagentId
+                            - label
+                            - status
+                          additionalProperties: false
+                        slackMessage:
+                          type: object
+                          properties:
+                            channelId:
+                              type: string
+                            channelName:
+                              type: string
+                            channelTs:
+                              type: string
+                            threadTs:
+                              type: string
+                            sender:
+                              type: object
+                              properties:
+                                displayName:
+                                  type: string
+                                externalUserId:
+                                  type: string
+                              additionalProperties: false
+                            messageLink:
+                              type: object
+                              properties:
+                                appUrl:
+                                  type: string
+                                webUrl:
+                                  type: string
+                              additionalProperties: false
+                            threadLink:
+                              type: object
+                              properties:
+                                appUrl:
+                                  type: string
+                                webUrl:
+                                  type: string
+                              additionalProperties: false
+                          required:
+                            - channelId
+                            - channelTs
+                          additionalProperties: false
+                      required:
+                        - id
+                        - role
+                        - timestamp
+                        - attachments
+                      additionalProperties: false
                     description: Array of message objects
                   hasMore:
                     description: Whether older messages exist beyond this page
@@ -14871,9 +16872,50 @@ paths:
                     anyOf:
                       - type: string
                       - type: "null"
+                  seq:
+                    description:
+                      Global SSE `seq` of the last event whose content is durably persisted for this conversation in the current
+                      daemon process. A client can align this snapshot with the `/events` stream by applying only events
+                      with `seq` greater than this value. Null when no events have been persisted in this process (cold
+                      conversation, after a daemon restart, or when the conversation has aged out of the in-memory map)
+                      — clients should cold-start in that case. Absent on older daemons that predate this field.
+                    anyOf:
+                      - type: number
+                      - type: "null"
                 required:
                   - messages
                 additionalProperties: false
+      parameters:
+        - name: conversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Conversation UUID. One of conversationId or conversationKey is required.
+        - name: conversationKey
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Channel/external conversation key. One of conversationId or conversationKey is required.
+        - name: page
+          in: query
+          required: false
+          schema:
+            type: string
+          description: When set to 'latest', returns the most recent page of messages with pagination metadata.
+        - name: beforeTimestamp
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Return messages older than this timestamp (ms since epoch). Used for paging older history.
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Maximum number of messages to return.
     post:
       operationId: messages_post
       summary: Send a message
@@ -14883,6 +16925,24 @@ paths:
       responses:
         "202":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  accepted:
+                    type: boolean
+                  conversationId:
+                    type: string
+                  messageId:
+                    type: string
+                  queued:
+                    type: boolean
+                  requestId:
+                    type: string
+                required:
+                  - accepted
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -14890,15 +16950,35 @@ paths:
             schema:
               type: object
               properties:
+                conversationId:
+                  description:
+                    Internal conversation id (0.8.6+ strict lookup). Omit both id and key to mint a new conversation
+                    server-side.
+                  anyOf:
+                    - type: string
+                    - type: "null"
                 conversationKey:
-                  type: string
+                  anyOf:
+                    - type: string
+                    - type: "null"
                 content:
                   type: string
                   description: Message text content
                 attachments:
                   type: array
                   items: {}
-                  description: Optional file attachments
+                  description: Optional inline file attachments
+                attachmentIds:
+                  type: array
+                  items:
+                    type: string
+                  description: Ids of previously uploaded attachments to attach
+                sourceChannel:
+                  type: string
+                  description: Originating channel id (e.g. "vellum")
+                interface:
+                  type: string
+                  description: Originating interface id (e.g. "vellum")
                 conversationType:
                   type: string
                 slashCommand:
@@ -14916,8 +16996,57 @@ paths:
                     - low
                     - medium
                     - high
+                onboarding:
+                  type: object
+                  properties:
+                    tools:
+                      type: array
+                      items:
+                        type: string
+                    tasks:
+                      type: array
+                      items:
+                        type: string
+                    tone:
+                      type: string
+                    userName:
+                      type: string
+                    assistantName:
+                      type: string
+                    googleConnected:
+                      type: boolean
+                    googleScopes:
+                      type: array
+                      items:
+                        type: string
+                    priorAssistants:
+                      type: array
+                      items:
+                        type: string
+                    cohort:
+                      type: string
+                    websiteUrl:
+                      type: string
+                    contentSourceUrl:
+                      type: string
+                    bootstrapTemplate:
+                      type: string
+                    initialMessage:
+                      type: string
+                    skills:
+                      type: array
+                      items:
+                        type: string
+                  required:
+                    - tools
+                    - tasks
+                    - tone
+                  additionalProperties: false
+                  description: PreChat onboarding context, sent on the first message only
               required:
                 - content
+                - sourceChannel
+                - interface
               additionalProperties: false
   /v1/messages/{id}/content:
     get:
@@ -16119,6 +18248,86 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  provider:
+                    anyOf:
+                      - type: object
+                        properties:
+                          provider_key:
+                            type: string
+                          display_name:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          description:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          dashboard_url:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          client_id_placeholder:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          requires_client_secret:
+                            type: boolean
+                          logo_url:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          supports_managed_mode:
+                            type: boolean
+                          managed_service_is_paid:
+                            type: boolean
+                          feature_flag:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                        required:
+                          - provider_key
+                          - display_name
+                          - description
+                          - dashboard_url
+                          - client_id_placeholder
+                          - requires_client_secret
+                          - logo_url
+                          - supports_managed_mode
+                          - managed_service_is_paid
+                          - feature_flag
+                        additionalProperties: false
+                      - type: "null"
+                  apps:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        provider_key:
+                          type: string
+                        client_id:
+                          type: string
+                        created_at:
+                          type: number
+                        updated_at:
+                          type: number
+                      required:
+                        - id
+                        - provider_key
+                        - client_id
+                        - created_at
+                        - updated_at
+                      additionalProperties: false
+                required:
+                  - provider
+                  - apps
+                additionalProperties: false
       parameters:
         - name: provider_key
           in: query
@@ -16135,6 +18344,52 @@ paths:
       responses:
         "201":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  app:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      provider_key:
+                        type: string
+                      client_id:
+                        type: string
+                      created_at:
+                        type: number
+                      updated_at:
+                        type: number
+                    required:
+                      - id
+                      - provider_key
+                      - client_id
+                      - created_at
+                      - updated_at
+                    additionalProperties: false
+                required:
+                  - app
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                provider_key:
+                  type: string
+                client_id:
+                  type: string
+                client_secret:
+                  type: string
+              required:
+                - provider_key
+                - client_id
+                - client_secret
+              additionalProperties: false
   /v1/oauth/apps/{appId}/connect:
     post:
       operationId: oauth_apps_by_appId_connect_post
@@ -16145,12 +18400,51 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                anyOf:
+                  - type: object
+                    properties:
+                      auth_url:
+                        type: string
+                      state:
+                        type: string
+                    required:
+                      - auth_url
+                      - state
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      ok:
+                        type: boolean
+                        const: true
+                    required:
+                      - ok
+                    additionalProperties: false
       parameters:
         - name: appId
           in: path
           required: true
           schema:
             type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                scopes:
+                  type: array
+                  items:
+                    type: string
+                callback_transport:
+                  type: string
+                  enum:
+                    - loopback
+                    - gateway
+              additionalProperties: false
   /v1/oauth/apps/{appId}/connections:
     get:
       operationId: oauth_apps_by_appId_connections_get
@@ -16161,6 +18455,54 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  connections:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        provider_key:
+                          type: string
+                        account_info:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        granted_scopes:
+                          type: array
+                          items:
+                            type: string
+                        status:
+                          type: string
+                        has_refresh_token:
+                          type: boolean
+                        expires_at:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        created_at:
+                          type: number
+                        updated_at:
+                          type: number
+                      required:
+                        - id
+                        - provider_key
+                        - account_info
+                        - granted_scopes
+                        - status
+                        - has_refresh_token
+                        - expires_at
+                        - created_at
+                        - updated_at
+                      additionalProperties: false
+                required:
+                  - connections
+                additionalProperties: false
       parameters:
         - name: appId
           in: path
@@ -16177,6 +18519,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -16193,6 +18545,34 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  app:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      provider_key:
+                        type: string
+                      client_id:
+                        type: string
+                      created_at:
+                        type: number
+                      updated_at:
+                        type: number
+                    required:
+                      - id
+                      - provider_key
+                      - client_id
+                      - created_at
+                      - updated_at
+                    additionalProperties: false
+                required:
+                  - app
+                additionalProperties: false
       parameters:
         - name: id
           in: query
@@ -16222,6 +18602,53 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  app:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      provider_key:
+                        type: string
+                      client_id:
+                        type: string
+                      created_at:
+                        type: number
+                      updated_at:
+                        type: number
+                    required:
+                      - id
+                      - provider_key
+                      - client_id
+                      - created_at
+                      - updated_at
+                    additionalProperties: false
+                required:
+                  - app
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                provider_key:
+                  type: string
+                client_id:
+                  type: string
+                client_secret:
+                  type: string
+                client_secret_credential_path:
+                  type: string
+              required:
+                - provider_key
+                - client_id
+              additionalProperties: false
   /v1/oauth/connection-changed:
     post:
       operationId: oauth_connectionchanged_post
@@ -16252,6 +18679,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -16341,6 +18778,63 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  providers:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        provider_key:
+                          type: string
+                        display_name:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        dashboard_url:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        client_id_placeholder:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        requires_client_secret:
+                          type: boolean
+                        logo_url:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        supports_managed_mode:
+                          type: boolean
+                        managed_service_is_paid:
+                          type: boolean
+                        feature_flag:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - provider_key
+                        - display_name
+                        - description
+                        - dashboard_url
+                        - client_id_placeholder
+                        - requires_client_secret
+                        - logo_url
+                        - supports_managed_mode
+                        - managed_service_is_paid
+                        - feature_flag
+                      additionalProperties: false
+                required:
+                  - providers
+                additionalProperties: false
       parameters:
         - name: supports_managed_mode
           in: query
@@ -16382,6 +18876,24 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  provider:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties: {}
+                  oauth_callback_url:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - provider
+                  - oauth_callback_url
+                additionalProperties: false
       parameters:
         - name: providerKey
           in: path
@@ -16554,6 +19066,41 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  routes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        assistant_id:
+                          type: string
+                        type:
+                          type: string
+                        callback_path:
+                          type: string
+                        callback_url:
+                          type: string
+                        source_identifier:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - id
+                        - assistant_id
+                        - type
+                        - callback_path
+                        - callback_url
+                        - source_identifier
+                      additionalProperties: false
+                required:
+                  - routes
+                additionalProperties: false
   /v1/platform/callback-routes/register:
     post:
       operationId: platform_callbackroutes_register_post
@@ -16564,6 +19111,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  callbackUrl:
+                    type: string
+                  callbackPath:
+                    type: string
+                  type:
+                    type: string
+                required:
+                  - callbackUrl
+                  - callbackPath
+                  - type
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                path:
+                  type: string
+                type:
+                  type: string
+              required:
+                - path
+                - type
+              additionalProperties: false
   /v1/platform/connect:
     post:
       operationId: platform_connect_post
@@ -16574,6 +19152,18 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  alreadyConnected:
+                    type: boolean
+                  baseUrl:
+                    type: string
+                  showPlatformLogin:
+                    type: boolean
+                additionalProperties: false
   /v1/platform/disconnect:
     post:
       operationId: platform_disconnect_post
@@ -16584,6 +19174,22 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  disconnected:
+                    type: boolean
+                    const: true
+                  previousBaseUrl:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - disconnected
+                  - previousBaseUrl
+                additionalProperties: false
   /v1/platform/status:
     get:
       operationId: platform_status_get
@@ -16594,6 +19200,57 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  isPlatform:
+                    type: boolean
+                  baseUrl:
+                    type: string
+                  assistantId:
+                    type: string
+                  hasAssistantApiKey:
+                    type: boolean
+                  hasWebhookSecret:
+                    type: boolean
+                  available:
+                    type: boolean
+                  organizationId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  userId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  velayTunnel:
+                    anyOf:
+                      - type: object
+                        properties:
+                          connected:
+                            type: boolean
+                          publicUrl:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                        required:
+                          - connected
+                          - publicUrl
+                        additionalProperties: false
+                      - type: "null"
+                required:
+                  - isPlatform
+                  - baseUrl
+                  - assistantId
+                  - hasAssistantApiKey
+                  - hasWebhookSecret
+                  - available
+                  - organizationId
+                  - userId
+                  - velayTunnel
+                additionalProperties: false
   /v1/playground/seed-conversation:
     post:
       operationId: playground_seedconversation_post
@@ -17492,6 +20149,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -17541,6 +20208,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -17628,6 +20298,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -17677,6 +20357,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -17790,6 +20473,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -17839,6 +20532,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -17925,6 +20621,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -17974,6 +20680,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -18103,6 +20812,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -18152,6 +20871,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -18239,6 +20961,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -18288,6 +21020,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -18354,6 +21089,14 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        conversationExists:
+                          type: boolean
+                        conversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        estimatedCostUsd:
+                          type: number
                         createdAt:
                           type: number
                       required:
@@ -18366,6 +21109,9 @@ paths:
                         - output
                         - error
                         - conversationId
+                        - conversationExists
+                        - conversationArchivedAt
+                        - estimatedCostUsd
                         - createdAt
                       additionalProperties: false
                     description: Schedule run objects
@@ -18453,6 +21199,16 @@ paths:
                           anyOf:
                             - type: number
                             - type: "null"
+                        createdFromConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdFromConversationExists:
+                          type: boolean
+                        createdFromConversationArchivedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                         description:
                           anyOf:
                             - type: string
@@ -18502,6 +21258,9 @@ paths:
                         - maxRetries
                         - retryBackoffMs
                         - timeoutMs
+                        - createdFromConversationId
+                        - createdFromConversationExists
+                        - createdFromConversationArchivedAt
                         - description
                         - mode
                         - status
@@ -18533,6 +21292,57 @@ paths:
               required:
                 - enabled
               additionalProperties: false
+  /v1/schedules/usage-summary:
+    get:
+      operationId: schedules_usagesummary_get
+      summary: Get schedule usage summaries
+      description: Return per-schedule run counts and usage totals for a time range.
+      tags:
+        - schedules
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  summaries:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        scheduleId:
+                          type: string
+                        runCount:
+                          type: number
+                        totalEstimatedCostUsd:
+                          type: number
+                        eventCount:
+                          type: number
+                      required:
+                        - scheduleId
+                        - runCount
+                        - totalEstimatedCostUsd
+                        - eventCount
+                      additionalProperties: false
+                    description: Schedule usage summary rows
+                required:
+                  - summaries
+                additionalProperties: false
+      parameters:
+        - name: from
+          in: query
+          required: true
+          schema:
+            type: integer
+          description: Start epoch millis (required)
+        - name: to
+          in: query
+          required: true
+          schema:
+            type: integer
+          description: End epoch millis (required)
   /v1/search:
     get:
       operationId: search_get
@@ -18821,11 +21631,37 @@ paths:
                 properties:
                   secrets:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        type:
+                          type: string
+                          enum:
+                            - api_key
+                            - credential
+                        name:
+                          type: string
+                      required:
+                        - type
+                        - name
+                      additionalProperties: false
                     description: List of secret metadata entries, each with type and name
                   accounts:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        type:
+                          type: string
+                          enum:
+                            - api_key
+                            - credential
+                        name:
+                          type: string
+                      required:
+                        - type
+                        - name
+                      additionalProperties: false
                     description: Alias for secrets (same data)
                 required:
                   - secrets
@@ -19192,6 +22028,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -19208,15 +22046,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: vellum
@@ -19237,6 +22066,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -19253,15 +22084,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: clawhub
@@ -19302,6 +22124,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -19318,15 +22142,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: skillssh
@@ -19382,6 +22197,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -19398,15 +22215,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: custom
@@ -19546,6 +22354,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -19562,15 +22372,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: vellum
@@ -19591,6 +22392,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -19607,15 +22410,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: clawhub
@@ -19710,6 +22504,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -19726,15 +22522,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: skillssh
@@ -19790,6 +22577,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -19806,15 +22595,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: custom
@@ -19964,6 +22744,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -19980,15 +22762,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: vellum
@@ -20009,6 +22782,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -20025,15 +22800,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: clawhub
@@ -20074,6 +22840,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -20090,15 +22858,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: skillssh
@@ -20154,6 +22913,8 @@ paths:
                             type: string
                           description:
                             type: string
+                          icon:
+                            type: string
                           emoji:
                             type: string
                           kind:
@@ -20170,15 +22931,6 @@ paths:
                               - available
                           category:
                             type: string
-                            enum:
-                              - communication
-                              - productivity
-                              - development
-                              - media
-                              - automation
-                              - webSocial
-                              - knowledge
-                              - integration
                           origin:
                             type: string
                             const: custom
@@ -20343,6 +23095,43 @@ paths:
           required: true
           schema:
             type: string
+  /v1/skills/categories:
+    get:
+      operationId: skills_categories_get
+      summary: List skill categories
+      description: Return all skill category definitions with labels, icons, and descriptions.
+      tags:
+        - skills
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  categories:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        slug:
+                          type: string
+                        label:
+                          type: string
+                        description:
+                          type: string
+                        icon:
+                          type: string
+                      required:
+                        - slug
+                        - label
+                        - description
+                        - icon
+                      additionalProperties: false
+                required:
+                  - categories
+                additionalProperties: false
   /v1/skills/check-updates:
     post:
       operationId: skills_checkupdates_post
@@ -20419,15 +23208,16 @@ paths:
               type: object
               properties:
                 slug:
+                  description: Skill slug. One of slug, url, or spec is required.
                   type: string
-                  description: Skill slug
                 url:
+                  description: Skill URL. One of slug, url, or spec is required.
                   type: string
-                  description: Skill URL
                 spec:
+                  description: Skill spec. One of slug, url, or spec is required.
                   type: string
-                  description: Skill spec
                 version:
+                  description: Specific version to install
                   type: string
                 origin:
                   description: Which registry to install from. When omitted, the install flow auto-detects based on slug format.
@@ -20443,11 +23233,6 @@ paths:
                     When true, restrict to bundled and Vellum catalog skills only — do not fall through to community
                     registries.
                   type: boolean
-              required:
-                - slug
-                - url
-                - spec
-                - version
               additionalProperties: false
   /v1/skills/search:
     get:
@@ -20476,6 +23261,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -20492,15 +23279,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: vellum
@@ -20521,6 +23299,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -20537,15 +23317,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: clawhub
@@ -20586,6 +23357,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -20602,15 +23375,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: skillssh
@@ -20666,6 +23430,8 @@ paths:
                               type: string
                             description:
                               type: string
+                            icon:
+                              type: string
                             emoji:
                               type: string
                             kind:
@@ -20682,15 +23448,6 @@ paths:
                                 - available
                             category:
                               type: string
-                              enum:
-                                - communication
-                                - productivity
-                                - development
-                                - media
-                                - automation
-                                - webSocial
-                                - knowledge
-                                - integration
                             origin:
                               type: string
                               const: custom
@@ -20730,6 +23487,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  channels:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        type:
+                          type: string
+                          enum:
+                            - channel
+                            - group
+                            - dm
+                        isPrivate:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - type
+                        - isPrivate
+                      additionalProperties: false
+                required:
+                  - channels
+                additionalProperties: false
   /v1/slack/share:
     post:
       operationId: slack_share_post
@@ -20740,6 +23528,42 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  ts:
+                    type: string
+                  channel:
+                    type: string
+                required:
+                  - ok
+                  - ts
+                  - channel
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                appId:
+                  type: string
+                  description: App to share
+                channelId:
+                  type: string
+                  description: Target Slack channel ID
+                message:
+                  description: Optional accompanying message
+                  type: string
+              required:
+                - appId
+                - channelId
+              additionalProperties: false
   /v1/stt/providers:
     get:
       operationId: stt_providers_get
@@ -21901,6 +24725,58 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  rules:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        tool:
+                          type: string
+                        pattern:
+                          type: string
+                        risk:
+                          type: string
+                          enum:
+                            - low
+                            - medium
+                            - high
+                        description:
+                          type: string
+                        origin:
+                          type: string
+                          enum:
+                            - default
+                            - user_defined
+                        userModified:
+                          type: boolean
+                        deleted:
+                          type: boolean
+                        createdAt:
+                          type: string
+                        updatedAt:
+                          type: string
+                      required:
+                        - id
+                        - tool
+                        - pattern
+                        - risk
+                        - description
+                        - origin
+                        - userModified
+                        - deleted
+                        - createdAt
+                        - updatedAt
+                      additionalProperties: false
+                required:
+                  - rules
+                additionalProperties: false
       parameters:
         - name: tool
           in: query
@@ -22057,6 +24933,61 @@ paths:
                 - currentThreshold
                 - intent
               additionalProperties: false
+  /v1/tts/providers:
+    get:
+      operationId: tts_providers_get
+      summary: List TTS providers
+      description: Return the catalog of available TTS providers with client-facing metadata.
+      tags:
+        - tts
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  providers:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        displayName:
+                          type: string
+                        subtitle:
+                          type: string
+                        supportsVoiceSelection:
+                          type: boolean
+                        apiKeyPlaceholder:
+                          type: string
+                        credentialsGuide:
+                          type: object
+                          properties:
+                            description:
+                              type: string
+                            url:
+                              type: string
+                            linkLabel:
+                              type: string
+                          required:
+                            - description
+                            - url
+                            - linkLabel
+                          additionalProperties: false
+                      required:
+                        - id
+                        - displayName
+                        - subtitle
+                        - supportsVoiceSelection
+                        - apiKeyPlaceholder
+                        - credentialsGuide
+                      additionalProperties: false
+                required:
+                  - providers
+                additionalProperties: false
   /v1/tts/synthesize:
     post:
       operationId: tts_synthesize_post
@@ -22271,7 +25202,13 @@ paths:
           required: false
           schema:
             type: string
-          description: "Group by: actor, provider, model, conversation, call_site, inference_profile (required)"
+          description: "Group by: actor, provider, model, conversation, call_site, inference_profile, schedule (required)"
+        - name: scheduleId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional schedule id. When set, usage is attributed by cron run windows for that schedule.
   /v1/usage/daily:
     get:
       operationId: usage_daily_get
@@ -22348,6 +25285,12 @@ paths:
           description:
             IANA timezone identifier (e.g. "America/Los_Angeles"). Bucket boundaries and display labels are computed in
             this timezone. Defaults to "UTC" for backwards compatibility.
+        - name: scheduleId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional schedule id. When set, usage is attributed by cron run windows for that schedule.
   /v1/usage/series:
     get:
       operationId: usage_series_get
@@ -22451,7 +25394,7 @@ paths:
           required: false
           schema:
             type: string
-          description: "Group by: actor, provider, model, call_site, inference_profile (required)"
+          description: "Group by: actor, provider, model, call_site, inference_profile, schedule (required)"
         - name: tz
           in: query
           required: false
@@ -22460,6 +25403,12 @@ paths:
           description:
             IANA timezone identifier (e.g. "America/Los_Angeles"). Bucket boundaries and display labels are computed in
             this timezone. Defaults to "UTC".
+        - name: scheduleId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional schedule id. When set, usage is attributed by cron run windows for that schedule.
   /v1/usage/totals:
     get:
       operationId: usage_totals_get
@@ -22514,6 +25463,12 @@ paths:
           schema:
             type: integer
           description: End epoch millis (required)
+        - name: scheduleId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional schedule id. When set, usage is attributed by cron run windows for that schedule.
   /v1/user-routes/inspect:
     post:
       operationId: userroutes_inspect_post
@@ -22742,6 +25697,41 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  routes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        assistant_id:
+                          type: string
+                        type:
+                          type: string
+                        callback_path:
+                          type: string
+                        callback_url:
+                          type: string
+                        source_identifier:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - id
+                        - assistant_id
+                        - type
+                        - callback_path
+                        - callback_url
+                        - source_identifier
+                      additionalProperties: false
+                required:
+                  - routes
+                additionalProperties: false
   /v1/webhooks/register:
     post:
       operationId: webhooks_register_post
@@ -22754,6 +25744,44 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  callbackUrl:
+                    type: string
+                  type:
+                    type: string
+                  path:
+                    type: string
+                  mode:
+                    type: string
+                    enum:
+                      - platform
+                      - self-hosted
+                required:
+                  - callbackUrl
+                  - type
+                  - path
+                  - mode
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                type:
+                  type: string
+                path:
+                  type: string
+                source:
+                  type: string
+              required:
+                - type
+              additionalProperties: false
   /v1/work-items:
     get:
       operationId: workitems_get
@@ -23142,6 +26170,11 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
         "416":
           description: Range Not Satisfiable
       parameters: