npm - @catandbox/schrodinger-contracts - Versions diffs - 0.1.0 - Mend

@catandbox/schrodinger-contracts 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/generated/client.ts +74 -0
package/generated/types.ts +543 -0
package/openapi/schrodinger.openapi.yaml +2463 -0
package/package.json +18 -0
package/src/index.ts +2 -0

package/openapi/schrodinger.openapi.yaml ADDED Viewed

@@ -0,0 +1,2463 @@
+openapi: 3.1.0
+info:
+  title: Schrodinger Helpdesk API
+  version: 0.1.0
+servers:
+  - url: https://api.example.com
+components:
+  securitySchemes:
+    SchrodingerSignedHeaders:
+      type: apiKey
+      in: header
+      name: X-Sch-Signature
+    AdminBearer:
+      type: http
+      scheme: bearer
+      bearerFormat: token
+  parameters:
+    TicketId:
+      name: ticketId
+      in: path
+      required: true
+      schema:
+        type: string
+    CategoryId:
+      name: categoryId
+      in: path
+      required: true
+      schema:
+        type: string
+  schemas:
+    ErrorResponse:
+      type: object
+      required: [error, message]
+      properties:
+        error:
+          type: string
+        message:
+          type: string
+        requestId:
+          type: string
+    TicketStatus:
+      type: string
+      enum: [Active, InProgress, AwaitingResponse, Closed, Archived]
+    Ticket:
+      type: object
+      required: [id, tenantId, principalId, status, title, createdAt, updatedAt]
+      properties:
+        id:
+          type: string
+        tenantId:
+          type: string
+        principalId:
+          type: string
+        categoryId:
+          type: string
+          nullable: true
+        status:
+          $ref: "#/components/schemas/TicketStatus"
+        title:
+          type: string
+          maxLength: 2048
+        assignedAliasId:
+          type: string
+          nullable: true
+        createdAt:
+          type: integer
+        updatedAt:
+          type: integer
+    Message:
+      type: object
+      required: [id, ticketId, authorType, isPublic, bodyPlain, createdAt]
+      properties:
+        id:
+          type: string
+        ticketId:
+          type: string
+        authorType:
+          type: string
+          enum: [customer, agent, admin, system]
+        isPublic:
+          type: boolean
+        bodyPlain:
+          type: string
+          maxLength: 65535
+        authorAliasId:
+          type: string
+          nullable: true
+        createdAt:
+          type: integer
+    Category:
+      type: object
+      required: [id, integrationId, name]
+      properties:
+        id:
+          type: string
+        integrationId:
+          type: string
+        name:
+          type: string
+        isDeleted:
+          type: boolean
+    PublicCategory:
+      type: object
+      required: [id, name]
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+    Alias:
+      type: object
+      required: [id, integrationId, department, displayName, isActive]
+      properties:
+        id:
+          type: string
+        integrationId:
+          type: string
+        department:
+          type: string
+        displayName:
+          type: string
+        avatarUrl:
+          type: string
+          nullable: true
+        toneStyle:
+          type: object
+          additionalProperties: true
+        isActive:
+          type: boolean
+    Macro:
+      type: object
+      required: [id, integrationId, title, bodyTemplate, isActive, createdAt, updatedAt]
+      properties:
+        id:
+          type: string
+        integrationId:
+          type: string
+        categoryId:
+          type: string
+          nullable: true
+        title:
+          type: string
+        bodyTemplate:
+          type: string
+        isActive:
+          type: boolean
+        createdAt:
+          type: integer
+        updatedAt:
+          type: integer
+    RatingRequest:
+      type: object
+      required: [tenantExternalId, principalExternalId, stars]
+      properties:
+        tenantExternalId:
+          type: string
+        principalExternalId:
+          type: string
+        stars:
+          type: integer
+          minimum: 1
+          maximum: 5
+        comment:
+          type: string
+          nullable: true
+    PortalConfig:
+      type: object
+      required: [categories, aliases]
+      properties:
+        categories:
+          type: array
+          items:
+            type: object
+            required: [id, name]
+            properties:
+              id:
+                type: string
+              name:
+                type: string
+        aliases:
+          type: array
+          items:
+            $ref: "#/components/schemas/Alias"
+    UploadInitRequest:
+      type: object
+      required: [tenantExternalId, principalExternalId, ticketId, files]
+      properties:
+        tenantExternalId:
+          type: string
+        principalExternalId:
+          type: string
+        ticketId:
+          type: string
+        files:
+          type: array
+          minItems: 1
+          maxItems: 5
+          items:
+            type: object
+            required: [filename, mime, sizeBytes, sha256]
+            properties:
+              filename:
+                type: string
+              mime:
+                type: string
+              sizeBytes:
+                type: integer
+                maximum: 5242880
+              sha256:
+                type: string
+    UploadCompleteRequest:
+      type: object
+      required: [tenantExternalId, principalExternalId, ticketId, uploads]
+      properties:
+        tenantExternalId:
+          type: string
+        principalExternalId:
+          type: string
+        ticketId:
+          type: string
+        messageId:
+          type: string
+          nullable: true
+        uploads:
+          type: array
+          minItems: 1
+          items:
+            type: object
+            required: [uploadId, sizeBytes, sha256]
+            properties:
+              uploadId:
+                type: string
+              sizeBytes:
+                type: integer
+              sha256:
+                type: string
+    CreateTicketRequest:
+      type: object
+      required: [tenantExternalId, principalExternalId, title, body, clientMessageId]
+      properties:
+        tenantExternalId:
+          type: string
+        principalExternalId:
+          type: string
+        categoryId:
+          type: string
+          nullable: true
+        title:
+          type: string
+          maxLength: 2048
+        body:
+          type: string
+          maxLength: 65535
+        clientMessageId:
+          type: string
+        notifyEmail:
+          type: string
+          format: email
+          nullable: true
+          description: Customer email to notify when agent responds
+    TicketEvent:
+      type: object
+      required: [id, ticketId, eventType, payload, createdAt]
+      properties:
+        id:
+          type: string
+        ticketId:
+          type: string
+        eventType:
+          type: string
+        payload:
+          type: object
+        createdAt:
+          type: integer
+    CreateMessageRequest:
+      type: object
+      required: [tenantExternalId, principalExternalId, body, clientMessageId]
+      properties:
+        tenantExternalId:
+          type: string
+        principalExternalId:
+          type: string
+        body:
+          type: string
+          maxLength: 65535
+        clientMessageId:
+          type: string
+    CreateIntegrationRequest:
+      type: object
+      required: [name, platform]
+      properties:
+        name:
+          type: string
+        platform:
+          type: string
+    Integration:
+      type: object
+      required: [id, name, platform, status, createdAt]
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        platform:
+          type: string
+        status:
+          type: string
+          enum: [active, disabled]
+        createdAt:
+          type: integer
+    CreatedKey:
+      type: object
+      required: [keyId, secret, createdAt]
+      properties:
+        keyId:
+          type: string
+        secret:
+          type: string
+        createdAt:
+          type: integer
+    RagScope:
+      type: string
+      enum: [shopify_common, app_specific]
+    RagSeverity:
+      type: string
+      enum: [critical, normal]
+    RagSource:
+      type: object
+      required: [id, ragScope, integrationId, url, type, status, lastFetchedAt]
+      properties:
+        id:
+          type: string
+        ragScope:
+          $ref: "#/components/schemas/RagScope"
+        integrationId:
+          type: string
+          nullable: true
+        url:
+          type: string
+        type:
+          type: string
+        status:
+          type: string
+        lastFetchedAt:
+          type: integer
+          nullable: true
+    RagGoldenTest:
+      type: object
+      required: [id, ragScope, integrationId, question, expectedPoints, severity, isActive]
+      properties:
+        id:
+          type: string
+        ragScope:
+          $ref: "#/components/schemas/RagScope"
+        integrationId:
+          type: string
+          nullable: true
+        question:
+          type: string
+        expectedPoints:
+          nullable: true
+        severity:
+          $ref: "#/components/schemas/RagSeverity"
+        isActive:
+          type: boolean
+    RagGoldenRunSummary:
+      type: object
+      required: [total, criticalFailures, avgCandidateScore, avgBaselineScore, avgDrop, threshold]
+      properties:
+        total:
+          type: integer
+        criticalFailures:
+          type: integer
+        avgCandidateScore:
+          type: number
+        avgBaselineScore:
+          type: number
+        avgDrop:
+          type: number
+        threshold:
+          type: number
+    AnalyticsStatusCount:
+      type: object
+      required: [status, count]
+      properties:
+        status:
+          $ref: "#/components/schemas/TicketStatus"
+        count:
+          type: integer
+    AnalyticsModeCount:
+      type: object
+      required: [mode, count]
+      properties:
+        mode:
+          type: string
+          enum: [manual, semi, auto]
+        count:
+          type: integer
+    AnalyticsBucketCount:
+      type: object
+      required: [bucketStart, count]
+      properties:
+        bucketStart:
+          type: integer
+        count:
+          type: integer
+    AnalyticsFirstResponseByPriority:
+      type: object
+      required: [priority, count, avgSeconds]
+      properties:
+        priority:
+          type: string
+          nullable: true
+          enum: [low, medium, high]
+        count:
+          type: integer
+        avgSeconds:
+          type: number
+    AnalyticsFirstResponseByCategory:
+      type: object
+      required: [categoryId, categoryName, count, avgSeconds]
+      properties:
+        categoryId:
+          type: string
+          nullable: true
+        categoryName:
+          type: string
+        count:
+          type: integer
+        avgSeconds:
+          type: number
+    AnalyticsDistributionPoint:
+      type: object
+      required: [stars, count]
+      properties:
+        stars:
+          type: integer
+        count:
+          type: integer
+    AnalyticsCategoryPoint:
+      type: object
+      required: [categoryId, categoryName, count]
+      properties:
+        categoryId:
+          type: string
+          nullable: true
+        categoryName:
+          type: string
+        count:
+          type: integer
+    AnalyticsModeTimelinePoint:
+      type: object
+      required: [bucketStart, mode, count]
+      properties:
+        bucketStart:
+          type: integer
+        mode:
+          type: string
+          enum: [manual, semi, auto]
+        count:
+          type: integer
+    AnalyticsRagOutcomePoint:
+      type: object
+      required: [bucketStart, status, count]
+      properties:
+        bucketStart:
+          type: integer
+        status:
+          type: string
+          enum: [running, passed, declined, error]
+        count:
+          type: integer
+    AnalyticsRagVersion:
+      type: object
+      required:
+        [
+          id,
+          ragScope,
+          integrationId,
+          vectorizeIndexName,
+          status,
+          createdAt,
+          promotedAt,
+          deprecatedAt,
+          declineReason
+        ]
+      properties:
+        id:
+          type: string
+        ragScope:
+          $ref: "#/components/schemas/RagScope"
+        integrationId:
+          type: string
+          nullable: true
+        vectorizeIndexName:
+          type: string
+        status:
+          type: string
+          enum: [candidate, active, deprecated, declined]
+        createdAt:
+          type: integer
+        promotedAt:
+          type: integer
+          nullable: true
+        deprecatedAt:
+          type: integer
+          nullable: true
+        declineReason:
+          type: string
+          nullable: true
+    GdprDeletionStats:
+      type: object
+      required:
+        [tenants, principals, tickets, messages, events, attachments, agentRuns, aliasRatings]
+      properties:
+        tenants:
+          type: integer
+        principals:
+          type: integer
+        tickets:
+          type: integer
+        messages:
+          type: integer
+        events:
+          type: integer
+        attachments:
+          type: integer
+        agentRuns:
+          type: integer
+        aliasRatings:
+          type: integer
+    GdprSelectorInput:
+      type: object
+      properties:
+        integrationId:
+          type: string
+          nullable: true
+        tenantExternalId:
+          type: string
+          nullable: true
+        shopDomain:
+          type: string
+          nullable: true
+        shop_domain:
+          type: string
+        shop_id:
+          oneOf:
+            - type: string
+            - type: integer
+    GdprCustomerInput:
+      type: object
+      properties:
+        id:
+          oneOf:
+            - type: string
+            - type: integer
+        email:
+          type: string
+    GdprCustomerSelectorInput:
+      allOf:
+        - $ref: "#/components/schemas/GdprSelectorInput"
+        - type: object
+          properties:
+            principalExternalId:
+              type: string
+            customer:
+              $ref: "#/components/schemas/GdprCustomerInput"
+paths:
+  /v1/tickets:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: createTicket
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateTicketRequest"
+      responses:
+        "201":
+          description: Ticket created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Ticket"
+        default:
+          description: Error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+    get:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: listTickets
+      parameters:
+        - name: tenantExternalId
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: status
+          in: query
+          required: false
+          schema:
+            $ref: "#/components/schemas/TicketStatus"
+      responses:
+        "200":
+          description: Ticket list
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Ticket"
+  /v1/tickets/{ticketId}:
+    get:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: getTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+        - name: tenantExternalId
+          in: query
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Ticket
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Ticket"
+        "404":
+          description: Not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+  /v1/tickets/{ticketId}/history:
+    get:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: getTicketHistory
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+        - name: tenantExternalId
+          in: query
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Ticket history events
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/TicketEvent"
+        default:
+          description: Error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+  /v1/tickets/{ticketId}/messages:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: createMessage
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateMessageRequest"
+      responses:
+        "201":
+          description: Message created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Message"
+  /v1/tickets/{ticketId}/close:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: closeTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [tenantExternalId]
+              properties:
+                tenantExternalId:
+                  type: string
+      responses:
+        "200":
+          description: Ticket updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Ticket"
+  /v1/tickets/{ticketId}/archive:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: archiveTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [tenantExternalId]
+              properties:
+                tenantExternalId:
+                  type: string
+      responses:
+        "200":
+          description: Ticket updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Ticket"
+  /v1/tickets/{ticketId}/reopen:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: reopenTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [tenantExternalId]
+              properties:
+                tenantExternalId:
+                  type: string
+      responses:
+        "200":
+          description: Ticket updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Ticket"
+  /v1/tickets/{ticketId}/ratings:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: rateTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/RatingRequest"
+      responses:
+        "200":
+          description: Ticket rating accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+  /v1/messages/{messageId}/ratings:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: rateMessage
+      parameters:
+        - name: messageId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/RatingRequest"
+      responses:
+        "200":
+          description: Message rating accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, aliasRated]
+                properties:
+                  ok:
+                    type: boolean
+                  aliasRated:
+                    type: boolean
+  /v1/categories:
+    get:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: listCategories
+      responses:
+        "200":
+          description: Categories
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/PublicCategory"
+  /v1/portal-config:
+    get:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: getPortalConfig
+      responses:
+        "200":
+          description: Portal configuration
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PortalConfig"
+  /v1/uploads/init:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: initUploads
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UploadInitRequest"
+      responses:
+        "200":
+          description: Upload sessions initialized
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [uploads]
+                properties:
+                  uploads:
+                    type: array
+                    items:
+                      type: object
+                      required: [uploadId, attachmentId, filename, putUrl]
+                      properties:
+                        uploadId:
+                          type: string
+                        attachmentId:
+                          type: string
+                        filename:
+                          type: string
+                        putUrl:
+                          type: string
+  /v1/uploads/complete:
+    post:
+      security:
+        - SchrodingerSignedHeaders: []
+      operationId: completeUploads
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/UploadCompleteRequest"
+      responses:
+        "200":
+          description: Upload completion accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [completed, scanStatus]
+                properties:
+                  completed:
+                    type: integer
+                  scanStatus:
+                    type: string
+                    enum: [pending]
+  /v1/uploads/{uploadId}/data:
+    put:
+      security: []
+      operationId: uploadAttachmentData
+      parameters:
+        - name: uploadId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: expires
+          in: query
+          required: true
+          schema:
+            type: integer
+        - name: sig
+          in: query
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/octet-stream:
+            schema:
+              type: string
+              format: binary
+      responses:
+        "200":
+          description: Upload accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+  /admin/integrations:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listIntegrations
+      responses:
+        "200":
+          description: Integration list
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Integration"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createIntegration
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreateIntegrationRequest"
+      responses:
+        "201":
+          description: Integration created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Integration"
+  /admin/integrations/{id}/keys:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listIntegrationKeys
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Keys list
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      type: object
+                      required: [keyId, createdAt]
+                      properties:
+                        keyId:
+                          type: string
+                        createdAt:
+                          type: integer
+                        revokedAt:
+                          type: integer
+                          nullable: true
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createIntegrationKey
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "201":
+          description: Key created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CreatedKey"
+  /admin/integrations/{id}/manual-categories:
+    put:
+      security:
+        - AdminBearer: []
+      operationId: updateManualCategories
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [manualCategoryIds]
+              properties:
+                manualCategoryIds:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        "200":
+          description: Updated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+  /admin/integrations/{id}/categories:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listAdminCategories
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Categories
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Category"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createCategory
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [name]
+              properties:
+                name:
+                  type: string
+      responses:
+        "201":
+          description: Category created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Category"
+  /admin/integrations/{id}/aliases:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listAliases
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Aliases
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Alias"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createAlias
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [department, displayName]
+              properties:
+                department:
+                  type: string
+                displayName:
+                  type: string
+                avatarUrl:
+                  type: string
+                  nullable: true
+                toneStyle:
+                  type: object
+                  additionalProperties: true
+                isActive:
+                  type: boolean
+      responses:
+        "201":
+          description: Alias created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Alias"
+  /admin/aliases/{aliasId}:
+    patch:
+      security:
+        - AdminBearer: []
+      operationId: updateAlias
+      parameters:
+        - name: aliasId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                department:
+                  type: string
+                displayName:
+                  type: string
+                avatarUrl:
+                  type: string
+                  nullable: true
+                toneStyle:
+                  type: object
+                  additionalProperties: true
+                isActive:
+                  type: boolean
+      responses:
+        "200":
+          description: Alias updated
+    delete:
+      security:
+        - AdminBearer: []
+      operationId: deleteAlias
+      parameters:
+        - name: aliasId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Alias deactivated
+  /admin/integrations/{id}/macros:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listMacros
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Macros
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/Macro"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createMacro
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [title, bodyTemplate]
+              properties:
+                categoryId:
+                  type: string
+                  nullable: true
+                title:
+                  type: string
+                bodyTemplate:
+                  type: string
+                isActive:
+                  type: boolean
+      responses:
+        "201":
+          description: Macro created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Macro"
+  /admin/macros/{macroId}:
+    patch:
+      security:
+        - AdminBearer: []
+      operationId: updateMacro
+      parameters:
+        - name: macroId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                categoryId:
+                  type: string
+                  nullable: true
+                title:
+                  type: string
+                bodyTemplate:
+                  type: string
+                isActive:
+                  type: boolean
+      responses:
+        "200":
+          description: Macro updated
+    delete:
+      security:
+        - AdminBearer: []
+      operationId: deleteMacro
+      parameters:
+        - name: macroId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Macro deleted
+  /admin/tickets/{ticketId}/pause:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: pauseTicketAutomation
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                pausedBy:
+                  type: string
+                reason:
+                  type: string
+      responses:
+        "200":
+          description: Ticket automation paused
+  /admin/tickets/{ticketId}/resume:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: resumeTicketAutomation
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                resumedBy:
+                  type: string
+      responses:
+        "200":
+          description: Ticket automation resumed
+  /admin/tickets/{ticketId}/escalate:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: escalateTicket
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                escalatedBy:
+                  type: string
+                reason:
+                  type: string
+      responses:
+        "200":
+          description: Ticket escalated
+  /admin/tickets/{ticketId}/draft:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createTicketDraft
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                requestedBy:
+                  type: string
+      responses:
+        "200":
+          description: Draft prepared
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [draftBody]
+                properties:
+                  draftBody:
+                    type: string
+  /admin/tickets/{ticketId}/respond:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: respondTicketManually
+      parameters:
+        - $ref: "#/components/parameters/TicketId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [body]
+              properties:
+                responder:
+                  type: string
+                body:
+                  type: string
+      responses:
+        "200":
+          description: Ticket response sent
+  /admin/gdpr/shop-redact:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: gdprShopRedact
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/GdprSelectorInput"
+      responses:
+        "200":
+          description: Shop data redaction accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, matchedTenants, deleted]
+                properties:
+                  ok:
+                    type: boolean
+                  matchedTenants:
+                    type: integer
+                  deleted:
+                    $ref: "#/components/schemas/GdprDeletionStats"
+  /admin/gdpr/customer-redact:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: gdprCustomerRedact
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/GdprCustomerSelectorInput"
+      responses:
+        "200":
+          description: Customer data redaction accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, matchedTenants, matchedPrincipals, deleted]
+                properties:
+                  ok:
+                    type: boolean
+                  matchedTenants:
+                    type: integer
+                  matchedPrincipals:
+                    type: integer
+                  deleted:
+                    $ref: "#/components/schemas/GdprDeletionStats"
+  /admin/gdpr/data-request:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: gdprDataRequest
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/GdprCustomerSelectorInput"
+      responses:
+        "200":
+          description: Customer data package
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, found, data]
+                properties:
+                  ok:
+                    type: boolean
+                  found:
+                    type: boolean
+                  data:
+                    type: object
+                    required:
+                      [tenants, principals, tickets, messages, events, attachments, aliasRatings]
+                    properties:
+                      tenants:
+                        type: array
+                        items:
+                          type: object
+                          required: [id, integrationId, externalTenantId, shopDomain]
+                          properties:
+                            id:
+                              type: string
+                            integrationId:
+                              type: string
+                            externalTenantId:
+                              type: string
+                            shopDomain:
+                              type: string
+                              nullable: true
+                      principals:
+                        type: array
+                        items:
+                          type: object
+                          required:
+                            [
+                              id,
+                              tenantId,
+                              externalPrincipalId,
+                              email,
+                              displayName,
+                              createdAt,
+                              lastSeenAt
+                            ]
+                          properties:
+                            id:
+                              type: string
+                            tenantId:
+                              type: string
+                            externalPrincipalId:
+                              type: string
+                            email:
+                              type: string
+                              nullable: true
+                            displayName:
+                              type: string
+                              nullable: true
+                            createdAt:
+                              type: integer
+                            lastSeenAt:
+                              type: integer
+                              nullable: true
+                      tickets:
+                        type: array
+                        items:
+                          type: object
+                          required: [id, tenantId, principalId, status, title, createdAt, updatedAt]
+                          properties:
+                            id:
+                              type: string
+                            tenantId:
+                              type: string
+                            principalId:
+                              type: string
+                            status:
+                              type: string
+                            title:
+                              type: string
+                            createdAt:
+                              type: integer
+                            updatedAt:
+                              type: integer
+                      messages:
+                        type: array
+                        items:
+                          type: object
+                          required: [id, ticketId, authorType, isPublic, bodyPlain, createdAt]
+                          properties:
+                            id:
+                              type: string
+                            ticketId:
+                              type: string
+                            authorType:
+                              type: string
+                            isPublic:
+                              type: boolean
+                            bodyPlain:
+                              type: string
+                            createdAt:
+                              type: integer
+                      events:
+                        type: array
+                        items:
+                          type: object
+                          required: [id, ticketId, eventType, payloadJson, createdAt]
+                          properties:
+                            id:
+                              type: string
+                            ticketId:
+                              type: string
+                            eventType:
+                              type: string
+                            payloadJson:
+                              type: string
+                            createdAt:
+                              type: integer
+                      attachments:
+                        type: array
+                        items:
+                          type: object
+                          required:
+                            [id, ticketId, messageId, filename, mime, sizeBytes, sha256, createdAt]
+                          properties:
+                            id:
+                              type: string
+                            ticketId:
+                              type: string
+                            messageId:
+                              type: string
+                              nullable: true
+                            filename:
+                              type: string
+                            mime:
+                              type: string
+                            sizeBytes:
+                              type: integer
+                            sha256:
+                              type: string
+                            createdAt:
+                              type: integer
+                      aliasRatings:
+                        type: array
+                        items:
+                          type: object
+                          required:
+                            [
+                              id,
+                              aliasId,
+                              tenantId,
+                              principalId,
+                              starsAvg,
+                              starsCount,
+                              lastStar,
+                              isBlockedForPrincipal
+                            ]
+                          properties:
+                            id:
+                              type: string
+                            aliasId:
+                              type: string
+                            tenantId:
+                              type: string
+                            principalId:
+                              type: string
+                            starsAvg:
+                              type: number
+                            starsCount:
+                              type: integer
+                            lastStar:
+                              type: integer
+                              nullable: true
+                            isBlockedForPrincipal:
+                              type: boolean
+  /admin/analytics/summary:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getAnalyticsSummary
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Analytics summary
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [window, tickets, csat, response, rag]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                  tickets:
+                    type: object
+                    required: [opened, byStatus]
+                    properties:
+                      opened:
+                        type: integer
+                      byStatus:
+                        type: object
+                        required: [Active, InProgress, AwaitingResponse, Closed, Archived]
+                        properties:
+                          Active:
+                            type: integer
+                          InProgress:
+                            type: integer
+                          AwaitingResponse:
+                            type: integer
+                          Closed:
+                            type: integer
+                          Archived:
+                            type: integer
+                  csat:
+                    type: object
+                    required: [ticketAverage, messageAverage]
+                    properties:
+                      ticketAverage:
+                        type: number
+                        nullable: true
+                      messageAverage:
+                        type: number
+                        nullable: true
+                  response:
+                    type: object
+                    required: [avgFirstResponseSeconds]
+                    properties:
+                      avgFirstResponseSeconds:
+                        type: number
+                        nullable: true
+                  rag:
+                    type: object
+                    required: [runsTotal, running, passed, declined, error]
+                    properties:
+                      runsTotal:
+                        type: integer
+                      running:
+                        type: integer
+                      passed:
+                        type: integer
+                      declined:
+                        type: integer
+                      error:
+                        type: integer
+  /admin/analytics/tickets:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getTicketAnalytics
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: bucketSeconds
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Ticket analytics
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  [
+                    window,
+                    openedSeries,
+                    byStatus,
+                    avgFirstResponseByPriority,
+                    avgFirstResponseByCategory
+                  ]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to, bucketSeconds]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                      bucketSeconds:
+                        type: integer
+                  openedSeries:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsBucketCount"
+                  byStatus:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsStatusCount"
+                  avgFirstResponseByPriority:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsFirstResponseByPriority"
+                  avgFirstResponseByCategory:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsFirstResponseByCategory"
+  /admin/analytics/csat:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getCsatAnalytics
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: CSAT analytics
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  [window, ticketDistribution, messageDistribution, ticketAverage, messageAverage]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                  ticketDistribution:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsDistributionPoint"
+                  messageDistribution:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsDistributionPoint"
+                  ticketAverage:
+                    type: number
+                    nullable: true
+                  messageAverage:
+                    type: number
+                    nullable: true
+  /admin/analytics/categories:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getCategoryAnalytics
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Category analytics
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [window, overall, perIntegration]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                  overall:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsCategoryPoint"
+                  perIntegration:
+                    type: array
+                    items:
+                      type: object
+                      required: [integrationId, items]
+                      properties:
+                        integrationId:
+                          type: string
+                        items:
+                          type: array
+                          items:
+                            $ref: "#/components/schemas/AnalyticsCategoryPoint"
+  /admin/analytics/modes:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getModeAnalytics
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: bucketSeconds
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: Automation mode analytics
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [window, snapshot, timeline]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to, bucketSeconds]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                      bucketSeconds:
+                        type: integer
+                  snapshot:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsModeCount"
+                  timeline:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsModeTimelinePoint"
+  /admin/analytics/rag:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: getRagAnalytics
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+        - name: bucketSeconds
+          in: query
+          required: false
+          schema:
+            type: integer
+      responses:
+        "200":
+          description: RAG analytics
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [window, versions, outcomesTimeline, runStatus]
+                properties:
+                  window:
+                    type: object
+                    required: [from, to, bucketSeconds]
+                    properties:
+                      from:
+                        type: integer
+                      to:
+                        type: integer
+                      bucketSeconds:
+                        type: integer
+                  versions:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsRagVersion"
+                  outcomesTimeline:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/AnalyticsRagOutcomePoint"
+                  runStatus:
+                    type: array
+                    items:
+                      type: object
+                      required: [status, count]
+                      properties:
+                        status:
+                          type: string
+                          enum: [running, passed, declined, error]
+                        count:
+                          type: integer
+  /admin/rag/sources:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listRagSources
+      parameters:
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        "200":
+          description: RAG sources list
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/RagSource"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createRagSource
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [ragScope, url, type]
+              properties:
+                ragScope:
+                  $ref: "#/components/schemas/RagScope"
+                integrationId:
+                  type: string
+                  nullable: true
+                url:
+                  type: string
+                type:
+                  type: string
+      responses:
+        "201":
+          description: RAG source created
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [id, ragScope, integrationId, url, type, status]
+                properties:
+                  id:
+                    type: string
+                  ragScope:
+                    $ref: "#/components/schemas/RagScope"
+                  integrationId:
+                    type: string
+                    nullable: true
+                  url:
+                    type: string
+                  type:
+                    type: string
+                  status:
+                    type: string
+        "409":
+          description: Source with the same URL already exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+  /admin/rag/sources/{sourceId}:
+    patch:
+      security:
+        - AdminBearer: []
+      operationId: updateRagSource
+      parameters:
+        - name: sourceId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                url:
+                  type: string
+                type:
+                  type: string
+                status:
+                  type: string
+                  enum: [active, inactive]
+      responses:
+        "200":
+          description: Source updated
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+        "404":
+          description: Source not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+        "409":
+          description: Source with the same URL already exists
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+    delete:
+      security:
+        - AdminBearer: []
+      operationId: deleteRagSource
+      parameters:
+        - name: sourceId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Source deleted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+        "404":
+          description: Source not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+  /admin/rag/build:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: buildRagCandidate
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [ragScope]
+              properties:
+                ragScope:
+                  $ref: "#/components/schemas/RagScope"
+                integrationId:
+                  type: string
+                  nullable: true
+      responses:
+        "201":
+          description: RAG candidate version created
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [versionId, vectorizeIndexName, status]
+                properties:
+                  versionId:
+                    type: string
+                  vectorizeIndexName:
+                    type: string
+                  status:
+                    type: string
+                    enum: [candidate]
+  /admin/rag/golden/run:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: runRagGoldenSuite
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [ragScope, candidateVersionId]
+              properties:
+                ragScope:
+                  $ref: "#/components/schemas/RagScope"
+                integrationId:
+                  type: string
+                  nullable: true
+                candidateVersionId:
+                  type: string
+                baselineVersionId:
+                  type: string
+                  nullable: true
+                judgeModel:
+                  type: string
+      responses:
+        "200":
+          description: Golden test run completed
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [runId, status, summary]
+                properties:
+                  runId:
+                    type: string
+                  status:
+                    type: string
+                    enum: [passed, declined]
+                  summary:
+                    $ref: "#/components/schemas/RagGoldenRunSummary"
+  /admin/rag/promote/{versionId}:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: promoteRagVersion
+      parameters:
+        - name: versionId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Candidate promoted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok, activatedVersionId, deprecatedVersionId]
+                properties:
+                  ok:
+                    type: boolean
+                  activatedVersionId:
+                    type: string
+                  deprecatedVersionId:
+                    type: string
+                    nullable: true
+  /admin/rag/deprecate/{versionId}:
+    post:
+      security:
+        - AdminBearer: []
+      operationId: deprecateRagVersion
+      parameters:
+        - name: versionId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                reason:
+                  type: string
+      responses:
+        "200":
+          description: Version deprecated
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+  /admin/rag/golden/tests:
+    get:
+      security:
+        - AdminBearer: []
+      operationId: listRagGoldenTests
+      parameters:
+        - name: ragScope
+          in: query
+          required: true
+          schema:
+            $ref: "#/components/schemas/RagScope"
+        - name: integrationId
+          in: query
+          required: false
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Golden tests list
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/RagGoldenTest"
+    post:
+      security:
+        - AdminBearer: []
+      operationId: createRagGoldenTest
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [ragScope, question, expectedPoints, severity]
+              properties:
+                ragScope:
+                  $ref: "#/components/schemas/RagScope"
+                integrationId:
+                  type: string
+                  nullable: true
+                question:
+                  type: string
+                expectedPoints:
+                  nullable: true
+                severity:
+                  $ref: "#/components/schemas/RagSeverity"
+                isActive:
+                  type: boolean
+      responses:
+        "201":
+          description: Golden test created
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [id]
+                properties:
+                  id:
+                    type: string
+  /admin/rag/golden/tests/{testId}:
+    patch:
+      security:
+        - AdminBearer: []
+      operationId: updateRagGoldenTest
+      parameters:
+        - name: testId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                question:
+                  type: string
+                expectedPoints:
+                  nullable: true
+                severity:
+                  $ref: "#/components/schemas/RagSeverity"
+                isActive:
+                  type: boolean
+      responses:
+        "200":
+          description: Golden test updated
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+    delete:
+      security:
+        - AdminBearer: []
+      operationId: deleteRagGoldenTest
+      parameters:
+        - name: testId
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Golden test deleted
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [ok]
+                properties:
+                  ok:
+                    type: boolean
+security:
+  - SchrodingerSignedHeaders: []