Coveo Analysis V3 API

openapi: 3.0.1
info:
  title: Coveo Activity Activities Analysis V3 API
  description: API for Coveo Platform
  termsOfService: https://www.coveo.com/en/support/terms-agreements
  contact:
    name: Coveo
    url: https://connect.coveo.com/s/discussions
  version: 1.0.0
servers:
- url: https://platform.cloud.coveo.com
  description: Coveo public API endpoint
security:
- oauth2:
  - full
tags:
- name: Analysis V3
  x-displayName: Analysis V3
paths:
  /rest/search/v3/analysis/expressions/structured:
    post:
      tags:
      - Analysis V3
      summary: Convert Query to Structured Expression
      description: 'Parses a query expression written using the Coveo query syntax, and converts it into a structured expression.

        to a structured expression.

        <details>

        <summary>Privilege(s) required</summary>


        ```json

        {"level":"NORMAL","owner":"SEARCH_API","targetDomain":"EXPRESSION_VALIDATION_RESULT","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: parseExpressionToStructured
      parameters:
      - $ref: '#/components/parameters/OrganizationIdQuery'
      requestBody:
        description: The query expression to parse and convert
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParseQueryExpressionToStructuredRequest'
        required: true
      responses:
        '200':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParseQueryExpressionToStructuredResponse'
              example:
                structured:
                  type: and
                  expressions:
                  - type: fieldExpression
                    fieldName: altpopulation
                    operator: greaterThanOrEqual
                    value:
                      type: unknown
                      value: '90000'
                  - type: fieldExists
                    fieldName: altcapital
                  - type: not
                    expression:
                      type: or
                      expressions:
                      - type: fieldExpression
                        fieldName: source
                        operator: isExactly
                        value:
                          type: string
                          value: Youtube
                      - type: fieldExpression
                        fieldName: author
                        operator: isExactly
                        value:
                          type: string
                          value: JohnSmith
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '419':
          $ref: '#/components/responses/AuthenticationTimeout'
        '422':
          description: Unprocessable Entity
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetailResponse'
              example:
                status: 422
                title: Invalid query expression
                detail: Coveo wasn't able to parse your query. Make sure it follows the Coveo query syntax.
      security:
      - oauth2:
        - full
  /rest/search/v3/analysis/inspect/replay:
    post:
      tags:
      - Analysis V3
      summary: Replay a Query with Inspection Details
      description: 'Replay a query that was already done and get inspection details.


        **Note:** This API call can only be used with an OAuth token. API Keys and Search Token aren''t allowed.

        <details>

        <summary>Privilege(s) required</summary>


        ```json

        {"level":"NORMAL","owner":"SEARCH_API","targetDomain":"EXECUTE_QUERY","type":"ENABLE","targetId":"*"},

        {"level":"NORMAL","owner":"SEARCH_API","targetDomain":"REPLAY_ANY_QUERY","type":"VIEW","targetId":"*"}

        ```

        </details>'
      operationId: replay
      parameters:
      - $ref: '#/components/parameters/OrganizationIdQuery'
      requestBody:
        description: Inspection parameters
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InspectReplayRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/application+json:
              schema:
                $ref: '#/components/schemas/InspectReplayResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/OriginalRequestNotFound'
        '419':
          $ref: '#/components/responses/AuthenticationTimeout'
        '422':
          $ref: '#/components/responses/UnsupportedRegion'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '503':
          $ref: '#/components/responses/ReplaySearchTooBroad'
      security:
      - oauth2:
        - full
components:
  schemas:
    ReplayExecutionStepRankingWeightsRule:
      allOf:
      - $ref: '#/components/schemas/ReplayRule'
    ProblemDetailResponse:
      type: object
      description: The Problem Details JSON Object [[RFC7807](https://tools.ietf.org/html/rfc7807)].
      minProperties: 1
      properties:
        status:
          type: integer
          minimum: 400
          maximum: 599
          description: The HTTP status code.
        title:
          type: string
          description: A short, human-readable summary of the problem type. This **shouldn't** change from one occurrence of the problem to another, except for localization purposes.
        type:
          type: string
          format: URI
          description: A URI reference [[RFC3986](https://tools.ietf.org/html/rfc3986)] that identifies and provides human-readable documentation for the problem type. When this isn't present, its value is assumed to be "about:blank".
        detail:
          type: string
          description: A human-readable explanation which is specific to this occurrence of the problem.
        instance:
          type: string
          format: URI
          description: A URI reference [[RFC3986](https://tools.ietf.org/html/rfc3986)] that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
    ReplayRule:
      type: object
      required:
      - id
      properties:
        id:
          type: string
          description: 'The identifier of the rule

            '
        condition:
          $ref: '#/components/schemas/ReplayCondition'
    ReplayExecutionStepFeaturedResultsRule:
      allOf:
      - $ref: '#/components/schemas/ReplayRule'
      - $ref: '#/components/schemas/ReplayAffectedResults'
    ReplayRankingInfoTermsWeight:
      type: object
      required:
      - term
      - weightInfo
      properties:
        term:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ReplayRankingInfoWeights'
            description: 'The weight factors applied to a specific term.

              '
        weightInfo:
          $ref: '#/components/schemas/ReplayRankingInfoWeights'
          description: 'A summary of the weight factors applied for these terms.

            '
    DictionaryFieldContext:
      type: object
      maxProperties: 255
      additionalProperties:
        type: string
        maxLength: 255
    ReplayExecutionStepBase:
      type: object
      required:
      - durationInMs
      properties:
        durationInMs:
          type: number
          description: 'Duration of the replay step in milliseconds.

            '
    NotKeywordExpressionV2:
      allOf:
      - $ref: '#/components/schemas/NotExpressionV2'
      - type: object
        required:
        - expression
        properties:
          expression:
            $ref: '#/components/schemas/KeywordExpressionV2'
    KeywordExpressionV2:
      description: Test
      type: object
      required:
      - type
      - value
      properties:
        type:
          type: string
          enum:
          - keyword
          description: An expression to match a literal in an item. The `value` may also be expanded with stemming.
        value:
          type: string
        stemming:
          type: boolean
          default: true
          description: 'Whether to enable stemming or not. See [About Stemming](https://docs.coveo.com/en/1576/) to learn more.

            '
    ReplayExecutionStepRankingExpressions:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - rankingExpressions
        name:
          type: string
          enum:
          - Ranking Expressions
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepRankingExpressionsRule'
    NewExpressionV2:
      description: As the expressions evolve, new expressions types might be added. To be forward compatible, you should always handle cases where something else could be returned.
    ReplayExecutionStepPipelineSelectionPipeline:
      type: object
      required:
      - id
      - name
      properties:
        id:
          type: string
          description: The identifier of the selected query pipeline
        name:
          type: string
          description: The name of the selected query pipeline
        condition:
          $ref: '#/components/schemas/ReplayCondition'
    EmptyExpressionV2:
      type: object
      required:
      - type
      properties:
        type:
          type: string
          enum:
          - empty
          description: An empty value. This is returned when the optimized parsed query expression is empty.
    ReplayExecutionStepPreprocessingIntegrations:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - preprocessingIntegrations
        name:
          type: string
          enum:
          - Preprocessing Integrations
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepIntegrationsPreprocessingRule'
    PostprocessingStateResponse:
      type: object
      properties:
        extendedResults:
          type: object
          maxProperties: 100
          additionalProperties:
            type: string
            maxLength: 100
    QueryExtensionInvocationExpressionV2:
      type: object
      required:
      - type
      - name
      - arguments
      properties:
        type:
          type: string
          enum:
          - queryExtension
          description: An expression that invokes a query extension.
        name:
          type: string
          description: The name of the query extension to invoke.
        arguments:
          type: object
          description: The arguments to provide to the query extension.
          additionalProperties:
            oneOf:
            - type: number
            - type: string
            - type: boolean
            - $ref: '#/components/schemas/QueryExpressionV2'
    ReplayIntegrationsProcessingFailure:
      type: object
      required:
      - error
      properties:
        error:
          $ref: '#/components/schemas/IntegrationErrorInfo'
    InspectReplayRequest:
      type: object
      required:
      - id
      properties:
        id:
          type: string
          description: The SearchUID of the request to replay.
        dateRange:
          type: object
          description: The date range within which to look for the request.
          required:
          - from
          properties:
            from:
              type: string
              format: date-time
              description: The inclusive date at which to start looking for the request.
            to:
              type: string
              format: date-time
              description: The inclusive date at which to stop looking for the SearchUID. When omitted searches up until the most recent requests.
    DateRangeValueV2:
      type: object
      required:
      - type
      - dateRange
      properties:
        type:
          type: string
          enum:
          - dateRange
          description: A range of dates to compare to the `fieldName`.
        dateRange:
          type: object
          required:
          - from
          - to
          properties:
            from:
              type: string
              format: date-time
            to:
              type: string
              format: date-time
    ReplayRankingInfoWeights:
      type: object
      description: 'Map of ranking factors and respective scores.

        '
      additionalProperties:
        type: number
        format: float
      example:
        title: 1000
        uri: 500
        source: 240
    IntegrationRankingFunction:
      type: object
      properties:
        expression:
          type: string
          maxLength: 2000
        normalizeWeight:
          type: boolean
        modifier:
          type: integer
        origin:
          $ref: '#/components/schemas/RankingOrigin'
        top:
          type: integer
          format: int64
      required:
      - expression
      - normalizeWeight
    NumericValueV2:
      type: object
      required:
      - type
      - numeric
      properties:
        type:
          type: string
          enum:
          - numeric
          description: A numeric value to compare to.
        numericValue:
          type: number
    ReplayExecutionStepSpecific:
      oneOf:
      - $ref: '#/components/schemas/ReplayExecutionStepPipelineSelection'
      - $ref: '#/components/schemas/ReplayExecutionStepRules'
      - $ref: '#/components/schemas/ReplayExecutionStepIndexQuery'
    ReplayExecutionStepRankingWeights:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - rankingWeights
        name:
          type: string
          enum:
          - Ranking Weights
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepRankingWeightsRule'
    ParseQueryExpressionToStructuredResponse:
      type: object
      required:
      - query
      properties:
        structured:
          $ref: '#/components/schemas/QueryExpressionV2'
          description: A structured version of the parsed query.
    ReplayExecutionStepRules:
      allOf:
      - $ref: '#/components/schemas/ListOfExecutionSteps'
      - $ref: '#/components/schemas/ReplayExecutionStepRulesBase'
    IntegrationQueryFunction:
      type: object
      properties:
        function:
          type: string
          maxLength: 2000
        fieldName:
          type: string
          maxLength: 255
        filterExpression:
          type: string
          maxLength: 50000
        origin:
          $ref: '#/components/schemas/RankingOrigin'
        top:
          type: integer
          format: int64
        allowMissingFields:
          type: boolean
      required:
      - function
      - fieldName
    ReplayExecutionStepDNE:
      type: object
      required:
      - type
      - name
      - applied
      properties:
        type:
          type: string
          enum:
          - dne
        name:
          type: string
          enum:
          - Dynamic Navigation Experience
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepDNERule'
    ReplayIntegrationsPreprocessingChanges:
      type: object
      properties:
        preprocessingStateChanges:
          $ref: '#/components/schemas/PreprocessingStateResponse'
    ReplayExecutionStepThesaurusRule:
      allOf:
      - $ref: '#/components/schemas/ReplayRule'
      - $ref: '#/components/schemas/ReplayAffectedRequestParameters'
    IntegrationErrorInfo:
      type: object
      required:
      - type
      - message
      properties:
        type:
          type: string
          description: 'The type of the error.

            '
        details:
          type: string
          description: 'The details of the error.

            '
    FieldValueV2:
      oneOf:
      - $ref: '#/components/schemas/FieldValueSupportedV2'
      - $ref: '#/components/schemas/NewExpressionV2'
    UnknownValueV2:
      type: object
      required:
      - type
      - value
      properties:
        type:
          type: string
          enum:
          - unknown
        value:
          type: string
          description: 'The value as it was parsed.

            '
    ReplayExecutionStep:
      allOf:
      - $ref: '#/components/schemas/ReplayExecutionStepBase'
      - $ref: '#/components/schemas/ReplayExecutionStepSpecific'
    TermsToContainExpressionV2:
      type: object
      required:
      - type
      - terms
      properties:
        type:
          type: string
          enum:
          - wordsToContain
        terms:
          type: array
          items:
            type: string
          description: 'The list of terms that must exist in the item.

            '
      description: 'An expression where each terms should exist in an item.

        '
    ReplayExecutionStepContentRecommendationRule:
      allOf:
      - $ref: '#/components/schemas/ReplayModelRule'
      - $ref: '#/components/schemas/ReplayAffectedResults'
    ReplayExecutionStepRankingExpressionsRuleBase:
      type: object
      properties:
        boost:
          type: number
          description: 'The boost applied by the rule to the results.

            '
    ReplayAffectedRequestParameters:
      type: object
      required:
      - affectedRequestParameters
      properties:
        affectedRequestParameters:
          type: array
          description: 'A list of request parameters that were affected by the rule.

            '
          items:
            $ref: '#/components/schemas/ReplayAffectedRequestParameter'
    ReplayIntegrationPreprocessingOutcome:
      anyOf:
      - $ref: '#/components/schemas/ReplayIntegrationsPreprocessingChanges'
      - $ref: '#/components/schemas/ReplayIntegrationsProcessingFailure'
    TextExpressionSupportedV2:
      oneOf:
      - $ref: '#/components/schemas/KeywordExpressionV2'
      - $ref: '#/components/schemas/NotKeywordExpressionV2'
      - $ref: '#/components/schemas/ExactMatchExpressionV2'
      - $ref: '#/components/schemas/TermsToContainExpressionV2'
      - $ref: '#/components/schemas/QuerySyntaxExpressionV2'
      discriminator:
        propertyName: type
        mapping:
          keyword: '#/components/schemas/KeywordExpressionV2'
          not: '#/components/schemas/NotKeywordExpressionV2'
          exactMatch: '#/components/schemas/ExactMatchExpressionV2'
          termsToContain: '#/components/schemas/TermsToContainExpressionV2'
          querySyntax: '#/components/schemas/QuerySyntaxExpressionV2'
    TextExpressionV2:
      oneOf:
      - $ref: '#/components/schemas/TextExpressionSupportedV2'
      - $ref: '#/components/schemas/NewExpressionV2'
    PreprocessingStateResponse:
      type: object
      properties:
        q:
          type: string
          maxLength: 50000
        aq:
          type: string
          maxLength: 50000
        cq:
          type: string
          maxLength: 50000
        dq:
          type: string
          maxLength: 15000
        fieldsToInclude:
          type: array
          maxItems: 255
          items:
            type: string
            maxLength: 255
        fieldsToExclude:
          type: array
          maxItems: 255
          items:
            type: string
            maxLength: 255
        firstResult:
          type: integer
        rankingExpressions:
          type: array
          maxItems: 500
          items:
            $ref: '#/components/schemas/IntegrationRankingExpression'
        rankingFunctions:
          type: array
          maxItems: 500
          items:
            $ref: '#/components/schemas/IntegrationRankingFunction'
        queryFunctions:
          type: array
          maxItems: 500
          items:
            $ref: '#/components/schemas/IntegrationQueryFunction'
        featureVectors:
          $ref: '#/components/schemas/FeatureVector'
        dictionaryFieldContext:
          $ref: '#/components/schemas/DictionaryFieldContext'
        warnings:
          type: array
          maxItems: 100
          items:
            type: string
            maxLength: 255
    ReplayExecutionStepTriggers:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - triggers
        name:
          type: string
          enum:
          - Triggers
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepTriggersRule'
    FieldOperatorV2:
      type: string
      enum:
      - contains
      - isExactly
      - lowerThan
      - lowerThanOrEqual
      - greaterThan
      - greaterThanOrEqual
      - phoneticMatch
      - fuzzyMatch
      - regexMatch
      - wildcardMatch
      - differentThan
      description: The comparison to make against the `value`.
    DateValueV2:
      type: object
      required:
      - type
      - dateValue
      properties:
        type:
          type: string
          enum:
          - date
          description: A specific date to compare to the `fieldName`.
        dateValue:
          type: string
          format: date-time
    AndExpressionV2:
      type: object
      required:
      - type
      - expressions
      properties:
        type:
          type: string
          enum:
          - and
          description: A list of expressions to join with a logical `AND`.
        expressions:
          type: array
          items:
            $ref: '#/components/schemas/QueryExpressionV2'
    ParseQueryExpressionToStructuredRequest:
      type: object
      required:
      - query
      properties:
        query:
          type: string
          description: A query using the Coveo query syntax.
          example: '@altpopulation>=90000 AND @altcapital AND NOT (@source=="Youtube" OR @author=="JohnSmith")'
    StringValueV2:
      type: object
      required:
      - type
      - value
      properties:
        type:
          type: string
          enum:
          - string
        value:
          type: string
      description: 'A value containing a string.

        '
    ReplayIntegrationsPostprocessingChanges:
      type: object
      properties:
        postprocessingStateChanges:
          $ref: '#/components/schemas/PostprocessingStateResponse'
    ReplayIntegrationsBase:
      type: object
      required:
      - id
      - integrationType
      properties:
        id:
          type: string
          description: 'The identifier of the rule

            '
        condition:
          $ref: '#/components/schemas/ReplayCondition'
        integrationType:
          type: string
          description: 'The name of the pipeline integration being applied

            '
    ReplayExecutionStepFeaturedResults:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - featuredResults
        name:
          type: string
          enum:
          - Featured Results
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepFeaturedResultsRule'
    ReplayIntegrationPostprocessingOutcome:
      anyOf:
      - $ref: '#/components/schemas/ReplayIntegrationsPostprocessingChanges'
      - $ref: '#/components/schemas/ReplayIntegrationsProcessingFailure'
    FeatureVector:
      type: object
      maxProperties: 5000
      additionalProperties:
        type: array
        maxItems: 10000
        items:
          type: number
    ReplayExecutionStepProductRecommendation:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - productRecommendation
        name:
          type: string
          enum:
          - Product Recommendation
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepProductRecommendationRule'
    ReplayExecutionStepDNERule:
      allOf:
      - $ref: '#/components/schemas/ReplayModelRule'
    ReplayAffectedResults:
      type: object
      properties:
        affectedResultsPosition:
          type: array
          description: 'An array of `results` position. Each item represent a position in `results` where the result was affected by the rule.

            '
          items:
            type: integer
    ReplayExecutionStepProductRecommendationRule:
      allOf:
      - $ref: '#/components/schemas/ReplayModelRule'
      - $ref: '#/components/schemas/ReplayAffectedResults'
    ReplayExecutionStepFiltersRule:
      allOf:
      - $ref: '#/components/schemas/ReplayRule'
      - $ref: '#/components/schemas/ReplayAffectedRequestParameters'
    ReplayExecutionStepFilters:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - filters
        name:
          type: string
          enum:
          - Filters
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepFiltersRule'
    ReplayExecutionStepContentRecommendation:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - contentRecommendation
        name:
          type: string
          enum:
          - Content Recommendation
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepContentRecommendationRule'
    QuerySyntaxExpressionV2:
      type: object
      required:
      - type
      - value
      properties:
        type:
          type: string
          enum:
          - querySyntax
          description: A search expression that may contain advanced query syntax.
        value:
          type: string
          example: '@author ~= "name"'
    ReplayExecutionStepParamOverrides:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - paramOverrides
        name:
          type: string
          enum:
          - Query param overrides
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepParamOverridesRule'
    FieldExistsExpressionV2:
      type: object
      required:
      - type
      - fieldName
      properties:
        type:
          type: string
          enum:
          - fieldExists
          description: An expression that returns all of the items that have a field matching `fieldName`.
        fieldName:
          type: string
    ExactMatchExpressionV2:
      type: object
      required:
      - type
      - value
      properties:
        type:
          type: string
          enum:
          - exactMatch
          description: An expression that must appear in its entirety at least once in an item for that item to be returned.
        value:
          type: string
    ReplayExecutionStepRulesBase:
      oneOf:
      - $ref: '#/components/schemas/ReplayExecutionStepParamOverrides'
      - $ref: '#/components/schemas/ReplayExecutionStepThesaurus'
      - $ref: '#/components/schemas/ReplayExecutionStepStopWords'
      - $ref: '#/components/schemas/ReplayExecutionStepFilters'
      - $ref: '#/components/schemas/ReplayExecutionStepRankingExpressions'
      - $ref: '#/components/schemas/ReplayExecutionStepFeaturedResults'
      - $ref: '#/components/schemas/ReplayExecutionStepRankingWeights'
      - $ref: '#/components/schemas/ReplayExecutionStepContentRecommendation'
      - $ref: '#/components/schemas/ReplayExecutionStepProductRecommendation'
      - $ref: '#/components/schemas/ReplayExecutionStepART'
      - $ref: '#/components/schemas/ReplayExecutionStepDNE'
      - $ref: '#/components/schemas/ReplayExecutionStepTriggers'
      - $ref: '#/components/schemas/ReplayExecutionStepPreprocessingIntegrations'
      - $ref: '#/components/schemas/ReplayExecutionStepPostprocessingIntegrations'
      discriminator:
        propertyName: type
        mapping:
          triggers: '#/components/schemas/ReplayExecutionStepTriggers'
          dne: '#/components/schemas/ReplayExecutionStepDNE'
          art: '#/components/schemas/ReplayExecutionStepART'
          productRecommendation: '#/components/schemas/ReplayExecutionStepProductRecommendation'
          contentRecommendation: '#/components/schemas/ReplayExecutionStepContentRecommendation'
          rankingWeights: '#/components/schemas/ReplayExecutionStepRankingWeights'
          featuredResults: '#/components/schemas/ReplayExecutionStepFeaturedResults'
          rankingExpressions: '#/components/schemas/ReplayExecutionStepRankingExpressions'
          filters: '#/components/schemas/ReplayExecutionStepFilters'
          stopWords: '#/components/schemas/ReplayExecutionStepStopWords'
          thesaurus: '#/components/schemas/ReplayExecutionStepThesaurus'
          paramOverrides: '#/components/schemas/ReplayExecutionStepParamOverrides'
          preprocessingIntegrations: '#/components/schemas/ReplayExecutionStepPreprocessingIntegrations'
          postprocessingIntegrations: '#/components/schemas/ReplayExecutionStepPostprocessingIntegrations'
    ReplayExecutionStepPostprocessingIntegrations:
      type: object
      required:
      - type
      - name
      properties:
        type:
          type: string
          enum:
          - postprocessingIntegrations
        name:
          type: string
          enum:
          - Postprocessing Integrations
        rankedResults:
          type: array
          description: 'Compared to the `results` property, `rankedResults` only return a list of document identifiers and their associated score.

            This property allows to get the score of documents beyond the request page without affecting query performance.

            This information impacts how the Generate Answering model will generate citations.'
          items:
            type: object
            required:
            - identifier
            properties:
              identifier:
                type: string
                description: Item identifier. Usually corresponds to the [permanentId](https://docs.coveo.com/en/1913/leverage-machine-learning/about-the-permanentid-field) field).
              score:
                type: integer
        applied:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStepIntegrationsPostprocessingRule'
    RankingOrigin:
      type: object
      properties:
        id:
          type: string
          maxLength: 255
        type:
          type: string
          maxLength: 255
        origin:
          type: string
          maxLength: 255
      required:
      - type
      - origin
    InspectReplayResponse:
      type: object
      required:
      - requestParameters
      - execution
      - results
      - totalResultsCount
      properties:
        requestParameters:
          type: object
          additionalProperties: true
          example:
            q: adventure books
            aq: '@author=john'
        execution:
          type: array
          items:
            $ref: '#/components/schemas/ReplayExecutionStep'
        results:
          type: array
          items:
            $ref: '#/components/schemas/ReplayResult'
        totalResultsCount:
          type: integer
          description: 'The total number of items matching the query for the current user (security trimming applied).

            '
    QueryExpressionV2:
      oneOf:
      - $ref: '#/components/schemas/QueryExpressionSupportedV2'
      - $ref: '#/components/schemas/NewExpressionV2'
    ReplayRankingInfo:
      type: object
      required:
      - documentWeights
      - totalWeight
      properties:
        documentWeights:
          $ref: '#/components/schemas/ReplayRankingInfoWeights'
          description: 'Summary of all the weight factors applied to the item. The sum of each factor gives th

# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/coveo/refs/heads/main/openapi/coveo-analysis-v3-api-openapi.yml